Organizations API

Manage organizations and teams.

Organizations

List Organizations

GET /api/orgs

curl https://api.guts.network/api/orgs \
  -H "Authorization: Bearer guts_xxx"

Get an Organization

GET /api/orgs/{org}

{
  "id": "org_abc123",
  "name": "acme",
  "display_name": "Acme Corp",
  "description": "Building the future",
  "email": "contact@acme.com",
  "created_at": "2025-01-01T00:00:00Z",
  "members_count": 25,
  "repos_count": 42
}

Create an Organization

POST /api/orgs

curl -X POST https://api.guts.network/api/orgs \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "acme",
    "display_name": "Acme Corp",
    "description": "Building the future",
    "email": "contact@acme.com"
  }'

Update an Organization

PATCH /api/orgs/{org}

Delete an Organization

DELETE /api/orgs/{org}

Members

List Organization Members

GET /api/orgs/{org}/members

[
  {
    "user": "alice",
    "role": "owner",
    "joined_at": "2025-01-01T00:00:00Z"
  },
  {
    "user": "bob",
    "role": "admin",
    "joined_at": "2025-01-05T00:00:00Z"
  },
  {
    "user": "charlie",
    "role": "member",
    "joined_at": "2025-01-10T00:00:00Z"
  }
]

Member Roles

Role	Description
owner	Full access, can delete org
admin	Manage members and settings
member	Access to org resources

Add/Update Member

PUT /api/orgs/{org}/members/{username}

curl -X PUT https://api.guts.network/api/orgs/acme/members/dave \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "member"
  }'

Remove Member

DELETE /api/orgs/{org}/members/{username}

Teams

List Teams

GET /api/orgs/{org}/teams

[
  {
    "id": "team_xyz789",
    "name": "core-team",
    "description": "Core maintainers",
    "permission": "admin",
    "members_count": 5,
    "repos_count": 10
  },
  {
    "id": "team_abc123",
    "name": "contributors",
    "description": "External contributors",
    "permission": "write",
    "members_count": 20,
    "repos_count": 5
  }
]

Get a Team

GET /api/orgs/{org}/teams/{team}

Create a Team

POST /api/orgs/{org}/teams

curl -X POST https://api.guts.network/api/orgs/acme/teams \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "backend-team",
    "description": "Backend developers",
    "permission": "write"
  }'

Update a Team

PATCH /api/orgs/{org}/teams/{team}

Delete a Team

DELETE /api/orgs/{org}/teams/{team}

Team Members

List Team Members

GET /api/orgs/{org}/teams/{team}/members

Add Team Member

PUT /api/orgs/{org}/teams/{team}/members/{username}

curl -X PUT https://api.guts.network/api/orgs/acme/teams/backend-team/members/eve \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "member"
  }'

Remove Team Member

DELETE /api/orgs/{org}/teams/{team}/members/{username}

Team Repositories

List Team Repositories

GET /api/orgs/{org}/teams/{team}/repos

Add Repository to Team

PUT /api/orgs/{org}/teams/{team}/repos/{owner}/{repo}

curl -X PUT https://api.guts.network/api/orgs/acme/teams/backend-team/repos/acme/api-server \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "permission": "write"
  }'

Remove Repository from Team

DELETE /api/orgs/{org}/teams/{team}/repos/{owner}/{repo}

Invitations

List Pending Invitations

GET /api/orgs/{org}/invitations

Create Invitation

POST /api/orgs/{org}/invitations

curl -X POST https://api.guts.network/api/orgs/acme/invitations \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "role": "member",
    "team_ids": ["team_xyz789"]
  }'

Cancel Invitation

DELETE /api/orgs/{org}/invitations/{invitation_id}

Organization Repositories

List Organization Repositories

GET /api/orgs/{org}/repos

Create Repository in Organization

POST /api/orgs/{org}/repos

curl -X POST https://api.guts.network/api/orgs/acme/repos \
  -H "Authorization: Bearer guts_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "new-project",
    "description": "A new project",
    "private": true
  }'