Dominio de acciones

`job`

Todas las acciones que este dominio expone vía gitlab_execute_action, del manifiesto gitlab://tools. Cada entrada se despliega a su descripción completa y sus parámetros obligatorios.

25 · acciones5 · destructivas13 · solo lectura

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cuenta 868 operaciones en Community Edition y hasta 1.094 en el tier más alto de GitLab.com, mientras que este despliegue publica 768 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

Cada entrada dice también qué necesita un token de acceso personal fine-grained de GitLab para ejecutarla, tal como lo declara GitLab 19.4.1: todos los permisos de una línea, en uno de los ámbitos indicados. Cuando hay alternativas, basta con cualquiera.

Volver a la ficha del servidor

job.artifacts
Job Artifactssolo lectura
Download the full artifact archive for a CI job, or one report named by file_type (GitLab 19.4 or later), base64-encoded and truncated at 1MB. Returns: size, content, and truncation flag. See also: job.download_single_artifact, job.keep_artifacts, job.get.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job Artifact: Read en proyecto
job.cancel
Job Cancel
Cancel a CI job. Set force:true to cancel jobs already in a non-cancellable state (requires GitLab v17.2+). Returns: updated job state. See also: job.get, job.retry.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Update en proyecto
job.delete_artifacts
Job Delete Artifactsdestructiva
Delete the artifacts for one CI job (destructive). Returns: a success confirmation. See also: job.artifacts, job.get, job.delete_project_artifacts.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job Artifact: Delete en proyecto
job.delete_project_artifacts
Job Delete Project Artifactsdestructiva
Delete every eligible artifact across a project (destructive, irreversible). Returns: a success confirmation. See also: job.delete_artifacts, job.list_project, job.artifacts.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Artifact: Delete en proyecto
job.download_artifacts
Job Download Artifactssolo lectura
Download the latest successful artifacts archive for a ref and job name. Returns: archive size, content, and truncation flag. See also: job.artifacts, job.download_single_artifact, job.get.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Job Artifact: Read en proyecto
job.download_single_artifact
Job Download Single Artifactsolo lectura
Download one artifact file from a job by job_id and artifact_path. Returns: file size, raw content, and truncation flag. See also: job.artifacts, job.download_artifacts, job.get.
Parámetros obligatorios: artifact_path (string), job_id (integer), project_id (string|integer)
Token fine-grained: Job Artifact: Read en proyecto
job.download_single_artifact_by_ref
Job Download Single Artifact By Refsolo lectura
Download one artifact file from the latest successful job on a ref by name and path. Returns: file size, raw content, and truncation flag. See also: job.download_artifacts, job.download_single_artifact, job.get.
Parámetros obligatorios: artifact_path (string), job (string), project_id (string|integer), ref_name (string)
Token fine-grained: Job Artifact: Read en proyecto
job.erase
Job Erasedestructiva
Erase a finished CI job's trace log and artifacts (destructive). Returns: updated job state. See also: job.get, job.trace, job.artifacts.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Delete en proyecto
job.get
Job Getsolo lectura
Get one CI job. Returns: status, stage, ref, embedded commit/pipeline/project/runner/user objects, timing fields, and failure metadata. See also: job.trace, job.cancel, job.retry.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Read en proyecto
job.keep_artifacts
Job Keep Artifacts
Keep a CI job's artifacts by clearing their expiration. Returns: updated job state. See also: job.artifacts, job.get, job.download_artifacts.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job Artifact: Update en proyecto
job.list
Job Listsolo lectura
List CI jobs for one pipeline with status filters, keyset pagination, and ordering. Returns: job summaries with status, stage, ref, and pipeline association. See also: job.get, job.trace, pipeline.get.
Parámetros obligatorios: pipeline_id (integer), project_id (string|integer)
Token fine-grained: Pipeline: Read en proyecto
job.list_bridges
Job List Bridgessolo lectura
List CI bridge (trigger) jobs for one pipeline with keyset pagination. Returns: bridge summaries with status and downstream pipeline references. See also: job.list, pipeline.get, job.get.
Parámetros obligatorios: pipeline_id (integer), project_id (string|integer)
Token fine-grained: Pipeline: Read en proyecto
job.list_project
Job List Projectsolo lectura
List CI jobs in one project with filters, keyset pagination, and ordering. Returns: job summaries, status, stage, ref, and pipeline associations. See also: job.get, job.trace, pipeline.get.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Job: Read en proyecto
job.play
Job Play
Run a manual CI job with optional variable overrides. Returns: the started job state. See also: job.get, job.retry, job.trace.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Run en proyecto
job.retry
Job Retry
Retry a failed or canceled CI job. Returns: the newly created job state. See also: job.get, job.trace, job.cancel.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Run en proyecto
job.token_scope_add_group
Add Group Job Token Allowlist
Add a group to a project's CI/CD job token allowlist. Returns: the new allowlist entry with source project ID and target group ID. See also: job.token_scope_list_groups, job.token_scope_remove_group, job.token_scope_add_project.
Parámetros obligatorios: project_id (string|integer), target_group_id (integer)
Token fine-grained: Job Token Scope Allowlist: Create en proyecto
job.token_scope_add_project
Add Project Job Token Allowlist
Add a project to a project's CI/CD job token inbound allowlist. Returns: the new allowlist entry with source and target project IDs. See also: job.token_scope_list_inbound, job.token_scope_remove_project, job.token_scope_add_group.
Parámetros obligatorios: project_id (string|integer), target_project_id (integer)
Token fine-grained: Job Token Scope Allowlist: Create en proyecto
job.token_scope_get
Get Job Token Access Settingssolo lectura
Get a project's CI/CD job token access settings. Returns: whether inbound job token access is limited to the allowlist, and the deprecated outbound scope flag. See also: job.token_scope_patch, job.token_scope_list_inbound, job.token_scope_list_groups.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Job Token Scope: Read en proyecto
job.token_scope_list_groups
List Job Token Group Allowlistsolo lectura
List groups on a project's CI/CD job token allowlist. Returns: allowlisted groups with id, name and web URL plus pagination metadata. See also: job.token_scope_add_group, job.token_scope_remove_group, job.token_scope_get.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Job Token Scope Allowlist: Read en proyecto
job.token_scope_list_inbound
List Job Token Inbound Allowlistsolo lectura
List projects on a project's CI/CD job token inbound allowlist. Returns: allowlisted projects with their names, paths, description, visibility, web and clone URLs, topics, counts and namespace, plus pagination metadata. See also: job.token_scope_add_project, job.token_scope_remove_project, job.token_scope_get.
Parámetros obligatorios: project_id (string|integer)
Token fine-grained: Job Token Scope Allowlist: Read en proyecto
job.token_scope_patch
Patch Job Token Access Settings
Update a project's CI/CD job token access settings. Returns: a confirmation that the inbound scope setting was updated. See also: job.token_scope_get, job.token_scope_add_project, job.token_scope_add_group.
Parámetros obligatorios: enabled (boolean), project_id (string|integer)
Token fine-grained: Job Token Scope: Update en proyecto
job.token_scope_remove_group
Remove Group Job Token Allowlistdestructiva
Remove a group from a project's CI/CD job token allowlist. Returns: a success confirmation naming the removed group. See also: job.token_scope_list_groups, job.token_scope_add_group, job.token_scope_remove_project.
Parámetros obligatorios: project_id (string|integer), target_group_id (integer)
Token fine-grained: Job Token Scope Allowlist: Delete en proyecto
job.token_scope_remove_project
Remove Project Job Token Allowlistdestructiva
Remove a project from a project's CI/CD job token inbound allowlist. Returns: a success confirmation naming the removed project. See also: job.token_scope_list_inbound, job.token_scope_add_project, job.token_scope_remove_group.
Parámetros obligatorios: project_id (string|integer), target_project_id (integer)
Token fine-grained: Job Token Scope Allowlist: Delete en proyecto
job.trace
Job Tracesolo lectura
Get CI job trace output. Returns: text log with truncation metadata when logs exceed limits. See also: job.get, job.retry, job.cancel.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Read en proyecto
job.wait
Job Waitsolo lectura
Wait for a CI job to finish, polling until terminal state or timeout. Returns: final job snapshot, wait duration, poll count, and timed-out flag. See also: job.get, job.trace, job.retry.
Parámetros obligatorios: job_id (integer), project_id (string|integer)
Token fine-grained: Job: Read en proyecto

`job`

`job.artifacts`

`job.cancel`

`job.delete_artifacts`

`job.delete_project_artifacts`

`job.download_artifacts`

`job.download_single_artifact`

`job.download_single_artifact_by_ref`

`job.erase`

`job.get`

`job.keep_artifacts`

`job.list`

`job.list_bridges`

`job.list_project`

`job.play`

`job.retry`

`job.token_scope_add_group`

`job.token_scope_add_project`

`job.token_scope_get`

`job.token_scope_list_groups`

`job.token_scope_list_inbound`

`job.token_scope_patch`

`job.token_scope_remove_group`

`job.token_scope_remove_project`

`job.trace`

`job.wait`