runners

Accessed as client.user.actions.runners; the async client mirrors it.

SyncAsync

UserActionsRunners

The user.actions.runners namespace.

delete

delete(runner_id: str) -> None

Delete a particular user-level runner.

Parameters:

Name	Type	Description	Default
`runner_id`	`str`	ID of the runner	required

Returns:

Type	Description
`None`	No content.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: deleteUserRunner

get

get(runner_id: str) -> ActionRunner

Get a particular runner that belongs to the user.

Parameters:

Name	Type	Description	Default
`runner_id`	`str`	ID of the runner	required

Returns:

Type	Description
`ActionRunner`	ActionRunner represents a runner.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: getUserRunner

jobs

jobs(*, labels: str | None = None) -> list[ActionRunJob]

Search for user's action jobs according filter conditions.

Parameters:

Name	Type	Description	Default
`labels`	`str \| None`	a comma separated list of run job labels to search for	`None`

Returns:

Type	Description
`list[ActionRunJob]`	RunJobList is a list of action run jobs.

Raises:

Type	Description
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`ForbiddenError`	APIForbiddenError is a forbidden error response.

Operation ID: userSearchRunJobs

list

list(*, visible: bool | None = None, page: int | None = None, limit: int | None = None) -> Paginated[ActionRunner]

Get the user's runners.

Parameters:

Name	Type	Description	Default
`visible`	`bool \| None`	whether to include all visible runners (true) or only those that are directly owned by the user (false)	`None`
`page`	`int \| None`	1-based page to start iteration at.	`None`
`limit`	`int \| None`	Page size; the instance caps it server-side.	`None`

Returns:

Type	Description
`Paginated[ActionRunner]`	ActionRunnerList is a list of Forgejo Action runners.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: getUserRunners

register

register(*, description: str | None = None, ephemeral: bool | None = None, name: str) -> RegisterRunnerResponse

Register a new user-level runner.

Parameters:

Name	Type	Description	Default
`description`	`str \| None`	Description of the runner to register.	`None`
`ephemeral`	`bool \| None`	Register as ephemeral runner https://forgejo.org/docs/latest/admin/actions/security/#ephemeral-runner	`None`
`name`	`str`	Name of the runner to register. The name of the runner does not have to be unique.	required

Returns:

Type	Description
`RegisterRunnerResponse`	RegisterRunnerResponse contains the details of the just registered runner.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: registerUserRunner

registration_token

registration_token() -> RegistrationToken

Get the user's runner registration token.

This operation has been deprecated in Forgejo 15. Use the web UI or /user/actions/runners instead.

Returns:

Type	Description
`RegistrationToken`	RegistrationToken is a string used to register a runner with a server.

Raises:

Type	Description
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`ForbiddenError`	APIForbiddenError is a forbidden error response.

Deprecated

Deprecated in the vendored Spec; generated for compatibility.

Operation ID: userGetRunnerRegistrationToken

AsyncUserActionsRunners

The user.actions.runners namespace.

delete

delete(runner_id: str) -> None

Delete a particular user-level runner.

Parameters:

Name	Type	Description	Default
`runner_id`	`str`	ID of the runner	required

Returns:

Type	Description
`None`	No content.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: deleteUserRunner

get

get(runner_id: str) -> ActionRunner

Get a particular runner that belongs to the user.

Parameters:

Name	Type	Description	Default
`runner_id`	`str`	ID of the runner	required

Returns:

Type	Description
`ActionRunner`	ActionRunner represents a runner.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: getUserRunner

jobs

jobs(*, labels: str | None = None) -> list[ActionRunJob]

Search for user's action jobs according filter conditions.

Parameters:

Name	Type	Description	Default
`labels`	`str \| None`	a comma separated list of run job labels to search for	`None`

Returns:

Type	Description
`list[ActionRunJob]`	RunJobList is a list of action run jobs.

Raises:

Type	Description
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`ForbiddenError`	APIForbiddenError is a forbidden error response.

Operation ID: userSearchRunJobs

list

list(*, visible: bool | None = None, page: int | None = None, limit: int | None = None) -> AsyncPaginated[ActionRunner]

Get the user's runners.

Parameters:

Name	Type	Description	Default
`visible`	`bool \| None`	whether to include all visible runners (true) or only those that are directly owned by the user (false)	`None`
`page`	`int \| None`	1-based page to start iteration at.	`None`
`limit`	`int \| None`	Page size; the instance caps it server-side.	`None`

Returns:

Type	Description
`AsyncPaginated[ActionRunner]`	ActionRunnerList is a list of Forgejo Action runners.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: getUserRunners

register

register(*, description: str | None = None, ephemeral: bool | None = None, name: str) -> RegisterRunnerResponse

Register a new user-level runner.

Parameters:

Name	Type	Description	Default
`description`	`str \| None`	Description of the runner to register.	`None`
`ephemeral`	`bool \| None`	Register as ephemeral runner https://forgejo.org/docs/latest/admin/actions/security/#ephemeral-runner	`None`
`name`	`str`	Name of the runner to register. The name of the runner does not have to be unique.	required

Returns:

Type	Description
`RegisterRunnerResponse`	RegisterRunnerResponse contains the details of the just registered runner.

Raises:

Type	Description
`BadRequestError`	APIError is error format response.
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`NotFoundError`	APINotFound is a not found error response.

Operation ID: registerUserRunner

registration_token

registration_token() -> RegistrationToken

Get the user's runner registration token.

This operation has been deprecated in Forgejo 15. Use the web UI or /user/actions/runners instead.

Returns:

Type	Description
`RegistrationToken`	RegistrationToken is a string used to register a runner with a server.

Raises:

Type	Description
`UnauthorizedError`	APIUnauthorizedError is a unauthorized error response.
`ForbiddenError`	APIForbiddenError is a forbidden error response.

Deprecated

Deprecated in the vendored Spec; generated for compatibility.

Operation ID: userGetRunnerRegistrationToken