Organization API

Manage team members, roles, and organization settings for collaborative app store management.

Team Feature

Organization features are available on Pro and Enterprise plans. Free plans are limited to a single user.

Endpoints

Get your organization details and settings.

GET /api/v1/organization

Authentication

Requires API key with Authorization: Bearer <api_key> header

Response Example

{
  "success": true,
  "data": {
    "id": "org_abc123",
    "name": "Acme Inc",
    "plan": "Pro",
    "memberCount": 5,
    "settings": {
      "defaultLocale": "en-US",
      "requireApproval": true,
      "allowedDomains": ["acme.com"]
    },
    "createdAt": "2024-01-01T00:00:00Z"
  }
}

Code Examples

curl -X GET https://api.appstorecopilot.com/v1/organization \
  -H "Authorization: Bearer $ASC_API_KEY"

Update organization settings. Requires admin role.

PATCH /api/v1/organization

Authentication

Requires API key with Authorization: Bearer <api_key> header

Request Body

Name	Type	Required	Description
`name`	`string`	No	Organization display name
`settings`	`object`	No	Organization settings object

Response Example

{
  "success": true,
  "data": {
    "id": "org_abc123",
    "name": "Acme Corporation",
    "settings": {
      "defaultLocale": "en-US",
      "requireApproval": false
    }
  }
}

Code Examples

curl -X PATCH https://api.appstorecopilot.com/v1/organization \
  -H "Authorization: Bearer $ASC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "settings": {
      "requireApproval": false
    }
  }'

Get a list of all organization members.

GET /api/v1/organization/members

Authentication

Requires API key with Authorization: Bearer <api_key> header

Response Example

{
  "success": true,
  "data": {
    "members": [
      {
        "id": "user_abc123",
        "email": "admin@acme.com",
        "name": "John Admin",
        "role": "admin",
        "status": "active",
        "lastActive": "2024-01-20T14:30:00Z",
        "joinedAt": "2024-01-01T00:00:00Z"
      },
      {
        "id": "user_def456",
        "email": "dev@acme.com",
        "name": "Jane Developer",
        "role": "member",
        "status": "active",
        "lastActive": "2024-01-20T12:00:00Z",
        "joinedAt": "2024-01-05T10:00:00Z"
      }
    ]
  }
}

Code Examples

curl -X GET https://api.appstorecopilot.com/v1/organization/members \
  -H "Authorization: Bearer $ASC_API_KEY"

Invite a new member to your organization. They will receive an email invitation.

POST /api/v1/organization/members

Authentication

Requires API key with Authorization: Bearer <api_key> header

Request Body

Name	Type	Required	Description
`email`	`string`	Yes	Email address to invite
`role`	`string`	No	Role: admin, member, or viewer (default: `member`)

Response Example

{
  "success": true,
  "data": {
    "inviteId": "inv_abc123",
    "email": "newmember@acme.com",
    "role": "member",
    "expiresAt": "2024-01-27T15:00:00Z"
  },
  "message": "Invitation sent successfully"
}

Code Examples

curl -X POST https://api.appstorecopilot.com/v1/organization/members \
  -H "Authorization: Bearer $ASC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newmember@acme.com",
    "role": "member"
  }'

Update a member's role. Requires admin role.

PATCH /api/v1/organization/members/:memberId

Authentication

Requires API key with Authorization: Bearer <api_key> header

URL Parameters

Name	Type	Required	Description
`memberId`	`string`	Yes	The member ID to update

Request Body

Name	Type	Required	Description
`role`	`string`	Yes	New role: admin, member, or viewer

Response Example

{
  "success": true,
  "data": {
    "id": "user_def456",
    "role": "admin"
  }
}

Code Examples

curl -X PATCH https://api.appstorecopilot.com/v1/organization/members/user_def456 \
  -H "Authorization: Bearer $ASC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Remove a member from your organization. Requires admin role.

DELETE /api/v1/organization/members/:memberId

Authentication

Requires API key with Authorization: Bearer <api_key> header

URL Parameters

Name	Type	Required	Description
`memberId`	`string`	Yes	The member ID to remove

Response Example

{
  "success": true,
  "message": "Member removed successfully"
}

Code Examples

curl -X DELETE https://api.appstorecopilot.com/v1/organization/members/user_def456 \
  -H "Authorization: Bearer $ASC_API_KEY"

Member Roles

Role	Permissions
`admin`	Full access: manage members, billing, credentials, and all projects
`member`	Create/edit projects, metadata, translations, and screenshots
`viewer`	Read-only access to projects and metadata