Ahora la API REST está versionada. Para obtener más información, consulta "Acerca del control de versiones de la API".

Puntos de conexión de API REST para organizaciones de equipo empresarial

Use la API REST para crear y administrar asignaciones de organización para equipos empresariales en la empresa GitHub enterprise.

Acerca de las organizaciones del equipo empresarial

Nota:

Actualmente, estos puntos de conexión se encuentran en versión preliminar pública y están sujetos a cambios.

Esta documentación de la API está destinada a empresas en GitHub Enterprise Cloud.

Si tu empresa es Copilot Business para no GHE, consulta el vínculo de documentación de acceso anticipado que se te ha compartido anteriormente.

Estos puntos de conexión solo están disponibles para los miembros autenticados de la empresa del equipo empresarial con personal access tokens clásicos con el ámbito read:enterprise de las API GET y admin:enterprise para otras API.

Estos puntos de conexión no son compatibles con fine-grained personal access tokens o tokens de acceso a aplicaciones de GitHub.

GitHub genera el slug del equipo empresarial a partir del equipo name y agrega el prefijo ent:.

Get organization assignments

Get all organizations assigned to an enterprise team

Fine-grained access tokens for "Get organization assignments"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (read)

Parámetros para "Get organization assignments"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

Parámetros de consulta
Nombre, Tipo, Descripción
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." Valor predeterminado: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." Valor predeterminado: `1`

HTTP response status codes for "Get organization assignments"

Status code	Descripción
`200`	An array of organizations the team is assigned to

Code samples for "Get organization assignments"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

get/enterprises/{enterprise}/teams/{enterprise-team}/organizations

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations

An array of organizations the team is assigned to

Status: 200

{
  "login": "github",
  "id": 1,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
  "url": "https://api.github.com/orgs/github",
  "repos_url": "https://api.github.com/orgs/github/repos",
  "events_url": "https://api.github.com/orgs/github/events",
  "hooks_url": "https://api.github.com/orgs/github/hooks",
  "issues_url": "https://api.github.com/orgs/github/issues",
  "members_url": "https://api.github.com/orgs/github/members{/member}",
  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "description": "A great organization"
}

Add organization assignments

Assign an enterprise team to multiple organizations.

Fine-grained access tokens for "Add organization assignments"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

Parámetros para "Add organization assignments"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

Parámetros del cuerpo
Nombre, Tipo, Descripción
`organization_slugs` array of strings Obligatorio Organization slug to assign the team to.

HTTP response status codes for "Add organization assignments"

Status code	Descripción
`200`	Successfully assigned the enterprise team to organizations.

Code samples for "Add organization assignments"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/organizations/add

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/add \
  -d '{"organization_slugs":["github"]}'

Successfully assigned the enterprise team to organizations.

Status: 200

[
  {
    "login": "github",
    "id": 1,
    "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
    "url": "https://api.github.com/orgs/github",
    "repos_url": "https://api.github.com/orgs/github/repos",
    "events_url": "https://api.github.com/orgs/github/events",
    "hooks_url": "https://api.github.com/orgs/github/hooks",
    "issues_url": "https://api.github.com/orgs/github/issues",
    "members_url": "https://api.github.com/orgs/github/members{/member}",
    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "description": "A great organization"
  }
]

Remove organization assignments

Unassign an enterprise team from multiple organizations.

Fine-grained access tokens for "Remove organization assignments"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

Parámetros para "Remove organization assignments"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

Parámetros del cuerpo
Nombre, Tipo, Descripción
`organization_slugs` array of strings Obligatorio Organization slug to unassign the team from.

HTTP response status codes for "Remove organization assignments"

Status code	Descripción
`204`	Successfully unassigned the enterprise team from organizations.

Code samples for "Remove organization assignments"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/organizations/remove

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/remove \
  -d '{"organization_slugs":["github"]}'

Successfully unassigned the enterprise team from organizations.

Status: 204

Get organization assignment

Check if an enterprise team is assigned to an organization

Fine-grained access tokens for "Get organization assignment"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (read)

Parámetros para "Get organization assignment"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.
`org` string Obligatorio The organization name. The name is not case sensitive.

HTTP response status codes for "Get organization assignment"

Status code	Descripción
`200`	The team is assigned to the organization
`404`	The team is not assigned to the organization

Code samples for "Get organization assignment"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

get/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG

The team is assigned to the organization

Status: 200

{
  "login": "github",
  "id": 1,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
  "url": "https://api.github.com/orgs/github",
  "repos_url": "https://api.github.com/orgs/github/repos",
  "events_url": "https://api.github.com/orgs/github/events",
  "hooks_url": "https://api.github.com/orgs/github/hooks",
  "issues_url": "https://api.github.com/orgs/github/issues",
  "members_url": "https://api.github.com/orgs/github/members{/member}",
  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "description": "A great organization"
}

Add an organization assignment

Assign an enterprise team to an organization.

Fine-grained access tokens for "Add an organization assignment"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

Parámetros para "Add an organization assignment"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.
`org` string Obligatorio The organization name. The name is not case sensitive.

HTTP response status codes for "Add an organization assignment"

Status code	Descripción
`201`	Successfully assigned the enterprise team to the organization.

Code samples for "Add an organization assignment"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

put/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG

Successfully assigned the enterprise team to the organization.

Status: 201

{
  "login": "github",
  "id": 1,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
  "url": "https://api.github.com/orgs/github",
  "repos_url": "https://api.github.com/orgs/github/repos",
  "events_url": "https://api.github.com/orgs/github/events",
  "hooks_url": "https://api.github.com/orgs/github/hooks",
  "issues_url": "https://api.github.com/orgs/github/issues",
  "members_url": "https://api.github.com/orgs/github/members{/member}",
  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "description": "A great organization"
}

Delete an organization assignment

Unassign an enterprise team from an organization.

Fine-grained access tokens for "Delete an organization assignment"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

Parámetros para "Delete an organization assignment"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`enterprise-team` string Obligatorio The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.
`org` string Obligatorio The organization name. The name is not case sensitive.

HTTP response status codes for "Delete an organization assignment"

Status code	Descripción
`204`	Successfully unassigned the enterprise team from the organization.

Code samples for "Delete an organization assignment"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Request example

delete/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG

Successfully unassigned the enterprise team from the organization.

Status: 204