AgentConnect
Agents

Authorize an installation for an agent

Grant the agent every repository a live, unsuspended GitHub App installation claimed by this organization covers, at one tier (read by default); an explicit repository authorization on a covered repository keeps its own tier. Only an organization owner may do this, and no per-repository permission check runs. materialize defaults to on-demand; decision feeds the installation’s repositories to the per-session repository selector and needs the agent’s repositorySelector and daemons serving the agent that advertise repo-selector-v1 (409 REPOSITORY_SELECTOR_MISSING or DAEMON_FEATURE_MISSING otherwise), and always is never accepted. An agent holds at most one grant per installation.

POST
/v1/orgs/{orgId}/agents/{agentId}/installations

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
agentId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/orgs/string/agents/string/installations" \  -H "Content-Type: application/json" \  -d '{    "installationId": 1  }'
{  "id": "string",  "provider": "github",  "installationId": 0,  "accountLogin": "string",  "access": "read",  "materialize": "decision",  "createdBy": "string",  "createdAt": "string"}