AgentConnect
Gitea

Connect Gitea with a bot token

Verifies a bot user’s personal access token against the instance (§4.1): reads the user, applies the version floor (Gitea 1.23, Forgejo 15), probes the required scopes (read:user, write:repository, write:issue, read:organization), refuses a bot already serving another connection on this deployment and a second connection in this organization, then seals the token. The token is write-only and never returned.

POST
/v1/orgs/{orgId}/gitea/connections

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*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/gitea/connections" \  -H "Content-Type: application/json" \  -d '{    "token": "string"  }'
{  "id": "string",  "botUserId": "string",  "botUsername": "string",  "botDisplayName": "string",  "state": "connected",  "connectedBy": "string",  "credentialEpoch": "string",  "boundRepositories": -9007199254740991,  "instanceUrl": "string",  "instanceVersion": "string",  "instanceVersionSupported": true,  "instanceProduct": "gitea",  "instanceVersionFloor": "string",  "requiredScopes": [    "string"  ],  "lastVerifiedAt": "string",  "createdAt": "string"}