# Jobbie Enterprise API reference

> Everything an agent or developer needs to build on the Jobbie Enterprise API: authentication, every documented endpoint with its scopes, parameters, cURL request and response example, pagination, errors, and webhook verification.

- API base URL: `https://api.jobbie.bot/v1`
- This file: https://enterprise.jobbie.bot/enterprise-docs/jobbie-api.md
- Full guide (portal walkthroughs + this reference): https://enterprise.jobbie.bot/enterprise-docs/jobbie-docs.md
- Documentation in the portal: https://enterprise.jobbie.bot/docs

## Authentication and identifiers

Send an organization API key as a Bearer token: `Authorization: Bearer $JOBBIE_API_KEY`. Owners and admins create keys under **API keys** in the portal; the secret is shown once. A key grants access only to its own organization and never to Command Center or personal Jobbie endpoints. The organization ID alone does not authorize requests.

Keep the key in a server-side secret store. `JOBBIE_ORG_ID` is the organization UUID shown in the portal. `JOBBIE_MEMBER_ID` is a membership UUID from the roster, not a personal account ID. All example identities and values are fictional, and response bodies are excerpts: other fields may be returned.

Key scopes: `organization:read`, `users:read`, `applications:read`, `applications:write`, `emails:read`, `emails:write`, `users:write`, `autopilot:run`, `webhooks:read`, `webhooks:write`, `organization:write`, `linkedin:read`, `linkedin:write`, `credentials:read`. `credentials:read` reveals members' job-board passwords and is never granted by default.

Start with a read-only check:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

## Endpoint index

| Method | Path | Purpose | Scopes or authentication |
| --- | --- | --- | --- |
| GET | `/organizations/$JOBBIE_ORG_ID` | Organization and seats | organization:read |
| GET | `/enterprise/dashboard` | Dashboard summary and member roster | organization:read, users:read, applications:read, emails:read |
| GET | `/enterprise/applications` | All organization applications | users:read, applications:read |
| GET | `/enterprise/activity` | Activity graph | users:read, applications:read |
| GET | `/enterprise/emails` | Organization inbox | users:read, applications:read, emails:read |
| GET | `/enterprise/activity` | Activity graph (rolling window) | users:read, applications:read |
| GET | `/enterprise/users/$JOBBIE_MEMBER_ID/overview` | Member profile, recent applications, and emails | users:read, applications:read, emails:read |
| GET | `/enterprise/users/$JOBBIE_MEMBER_ID/applications` | Member application history | applications:read |
| GET | `/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID` | Application answers and timestamps | applications:read |
| POST | `/organizations/$JOBBIE_ORG_ID/users/managed/batch` | Create managed seats | users:write |
| PATCH | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat-expiry` | Extend a seat | users:write |
| POST | `/organizations/$JOBBIE_ORG_ID/autopilot` | Start Autopilot for members | autopilot:run |
| POST | `/organizations/$JOBBIE_ORG_ID/autopilot` | Pause Autopilot for members | autopilot:run |
| POST | `/organizations/$JOBBIE_ORG_ID/autopilot` | Switch members to Autopilot Max | autopilot:run |
| GET | `/organizations/$JOBBIE_ORG_ID/email-settings` | Read email branding | organization:read |
| PATCH | `/organizations/$JOBBIE_ORG_ID/email-settings` | Set the sender name and From address | organization:write |
| POST | `/organizations/$JOBBIE_ORG_ID/email-settings/verify` | Check From address verification | organization:write |
| PATCH | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/membership` | Deactivating a seat (locked) | users:write |
| POST | `/organizations` | Enroll an organization | Verified company owner session |
| GET | `/enterprise/access` | Check approval and access | Signed-in session |
| POST | `/enterprise/company-logo` | Upload company profile picture | Organization owner/admin session |
| GET | `/organizations/$JOBBIE_ORG_ID/api-keys` | List API keys | Organization owner/admin session |
| POST | `/organizations/$JOBBIE_ORG_ID/api-keys` | Create an API key | Organization owner/admin session |
| DELETE | `/organizations/$JOBBIE_ORG_ID/api-keys/$JOBBIE_KEY_ID` | Revoke an API key | Organization owner/admin session |
| GET | `/organizations/$JOBBIE_ORG_ID/profile-options` | Profile field options | users:read |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID` | Read a managed member profile | users:read |
| PATCH | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID` | Import a resume URL and update applicant information | users:write |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/resume` | Upload a resume PDF | users:write |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat` | Assign a seat to a member | users:write |
| DELETE | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat` | Release a seat | users:write |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles` | List a member's profiles | users:read |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles` | Add a profile | users:write |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX/activate` | Set a member's active profile | users:write |
| GET | `/enterprise/mailbox` | Cohort mailbox | emails:read |
| GET | `/enterprise/mailbox/inbound/$JOBBIE_EMAIL_ID` | Read a cohort email | emails:read |
| POST | `/enterprise/mailbox/read` | Mark filtered emails as read | emails:write |
| GET | `/enterprise/board` | Organization applications board | users:read, applications:read |
| POST | `/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/status` | Move an application to another stage | applications:write |
| POST | `/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/cancel` | Stop an application in progress | applications:write |
| GET | `/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/resume` | Open the resume sent with an application | applications:read |
| POST | `/enterprise/users/$JOBBIE_MEMBER_ID/applications/mark-applied` | Record an application made outside Jobbie | applications:write |
| DELETE | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX` | Delete an inactive member profile | users:write |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed` | Read member Indeed connection | users:read |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed` | Send member Indeed verification code | users:write |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed/verify` | Verify member Indeed account | users:write |
| DELETE | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed` | Disconnect member Indeed account | users:write |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin` | Read member LinkedIn connection | users:read, linkedin:read |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin` | Sign a member in to LinkedIn | users:write, linkedin:write |
| POST | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/verify` | Verify member LinkedIn sign-in | users:write, linkedin:write |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/connections` | List member LinkedIn connection requests | users:read, linkedin:read |
| DELETE | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin` | Disconnect member LinkedIn account | users:write, linkedin:write |
| GET | `/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/board-password` | Read a member's job board password | users:read, credentials:read |
| GET | `/organizations/$JOBBIE_ORG_ID/operations/$JOBBIE_OPERATION_ID` | Check resume import status | users:read |
| GET | `/organizations/$JOBBIE_ORG_ID/webhooks` | List webhook endpoints | webhooks:read |
| POST | `/organizations/$JOBBIE_ORG_ID/webhooks` | Create a webhook endpoint | webhooks:write, users:read, applications:read |
| PATCH | `/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID` | Update, pause, or resume a webhook endpoint | webhooks:write, users:read, applications:read |
| POST | `/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/test` | Send a test event | webhooks:write |
| GET | `/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/deliveries` | List recent deliveries | webhooks:read |
| DELETE | `/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID` | Delete a webhook endpoint | webhooks:write |

## Organization API (API key)

### Organization and seats

`GET /organizations/$JOBBIE_ORG_ID`

**Required scopes:** organization:read

Read purchased capacity and active/reserved seats. Available capacity is seatLimit minus active minus reserved.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "id": "org_example",
  "status": "active",
  "seatLimit": 20,
  "active": 3,
  "reserved": 0
}
```

### Dashboard summary and member roster

`GET /enterprise/dashboard`

**Required scopes:** organization:read, users:read, applications:read, emails:read

Optional query searches members. status supports all, active, pending, deactivated, expired. Pass nextCursor as cursor for the next page. Administrators also receive cohort (active seats split into autopilotOn, readyToStart and needsSetup; autopilotOff = readyToStart + needsSetup) and seats.openSlots; member sessions receive cohort: null and seats: null. Every roster item carries the member's search targeting (targetRoles, countries, workplacePreference, salaryMin, salaryMax).

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | `string` | Optional | Search member names or email; up to 200 characters. |
| `status` | query | `string` | Optional | all (default), active, pending, deactivated, or expired. |
| `limit` | query | `integer` | Optional | 1–100 members per page; default 8. |
| `cursor` | query | `string` | Optional | Use users.nextCursor from the previous response; keep the same filters. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/dashboard?status=active&limit=8" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "seats": {
    "purchased": 20,
    "active": 3,
    "reserved": 0,
    "openSlots": 17
  },
  "totals": {
    "applications": 42,
    "assessments": 1,
    "interviews": 2,
    "offers": 1,
    "rejections": 5
  },
  "cohort": {
    "autopilotOn": 2,
    "autopilotOff": 1,
    "readyToStart": 1,
    "needsSetup": 0
  },
  "users": {
    "items": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "firstName": "Alex",
        "lastName": "Morgan",
        "email": "alex@example.com",
        "membershipStatus": "active",
        "readyForAutopilot": true,
        "autopilotEnabled": true,
        "targetRoles": [
          "Software Engineer"
        ],
        "countries": [
          "United States"
        ],
        "workplacePreference": [
          "remote"
        ],
        "salaryMin": 100000,
        "salaryMax": 250000
      }
    ],
    "total": 1,
    "nextCursor": null
  }
}
```

### All organization applications

`GET /enterprise/applications`

**Required scopes:** users:read, applications:read

status is one of all (default), submitted, applied, assessment, interview, offer, rejected, in_progress, or failed. submitted includes applied, assessment, interview, offer, and rejected records; in_progress is an application being made right now; failed ended without a submission. Records are listed newest first by their last status change. statusUpdatedAt is when the current status was recorded; matchPercent and resumeName are null when not recorded; step names the stage an in_progress application is at and is null otherwise. limit is 1–100; follow nextCursor with the same status, member, and query.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `status` | query | `string` | Optional | all (default), submitted, applied, assessment, interview, offer, rejected, in_progress, or failed. |
| `member` | query | `string` | Optional | A membership ID; only that member's records. Member sessions are always limited to themselves. |
| `query` | query | `string` | Optional | Literal, case-insensitive substring of the company or title; up to 200 characters. |
| `limit` | query | `integer` | Optional | 1–100 applications per page; default 25. |
| `cursor` | query | `string` | Optional | Use nextCursor from the previous response; keep the same status, member, and query. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/applications?status=in_progress&limit=25" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "id": 48213,
      "company": "Example Labs",
      "title": "Operations Analyst",
      "status": "in_progress",
      "appliedAt": "2026-10-17T17:58:02Z",
      "statusUpdatedAt": "2026-10-17T17:58:02Z",
      "matchPercent": 87,
      "source": "",
      "resumeName": "Alex Morgan - Analyst.pdf",
      "step": "Filling out screener questions",
      "memberId": "00000000-0000-4000-8000-000000000001",
      "firstName": "Alex",
      "lastName": "Morgan"
    }
  ],
  "total": 1,
  "nextCursor": null
}
```

### Activity graph

`GET /enterprise/activity`

**Required scopes:** users:read, applications:read

Two shapes. range (24h, 7d, 14d, or 30d) returns per-member submission counts for a rolling window. interval (daily, weekly, or monthly) with periods returns calendar periods with a series of submissions and outcomes for the cohort chart, plus the same per-member values; when both are sent, interval wins. Buckets are period starts in UTC (weeks start Monday, months on the 1st) and the last bucket is the current, partial period. series.applications counts by application date; assessments, interviews, offers, and rejections count by the time the record's current status was recorded, so an application that moved from interview to offer appears in offers only.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `interval` | query | `string` | Optional | daily, weekly, or monthly. Returns calendar periods with the outcome series. |
| `periods` | query | `integer` | Optional | Number of periods ending now. Defaults 14 daily, 6 weekly, 6 monthly; at most 90, 26, and 24. |
| `range` | query | `string` | Optional | 24h, 7d (default), 14d, or 30d for the rolling-window form. Hourly buckets for 24h; daily buckets otherwise. Ignored when interval is sent. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/activity?interval=weekly&periods=6" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "interval": "weekly",
  "periods": 6,
  "buckets": [
    "2026-09-07T00:00:00Z",
    "2026-09-14T00:00:00Z",
    "2026-09-21T00:00:00Z",
    "2026-09-28T00:00:00Z",
    "2026-10-05T00:00:00Z",
    "2026-10-12T00:00:00Z"
  ],
  "endAt": "2026-10-17T18:02:11Z",
  "series": {
    "applications": [
      38,
      41,
      52,
      47,
      55,
      21
    ],
    "assessments": [
      0,
      1,
      0,
      0,
      1,
      0
    ],
    "interviews": [
      1,
      2,
      0,
      3,
      2,
      1
    ],
    "offers": [
      0,
      0,
      1,
      0,
      0,
      1
    ],
    "rejections": [
      4,
      6,
      5,
      9,
      7,
      2
    ]
  },
  "members": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "name": "Alex Morgan",
      "email": "alex@example.com",
      "values": [
        8,
        9,
        10,
        7,
        12,
        4
      ]
    }
  ]
}
```

### Organization inbox

`GET /enterprise/emails`

**Required scopes:** users:read, applications:read, emails:read

Forwarded employer replies across the organization, newest first, each with the member and the organization-owned application it belongs to. Member sessions receive only their own mail. Verification mail is never included. outcome is assessment, interview, offer, rejected, or null when the mail did not change the application's status. There is no per-reader read state; last24h counts mail received in the last 24 hours.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | `integer` | Optional | 1–100 messages per page; default 25. |
| `cursor` | query | `string` | Optional | Use nextCursor from the previous response. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/emails?limit=25" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "id": "4f8d4a6e-0000-4000-8000-000000000042",
      "subject": "Interview availability – Operations Analyst",
      "from": "recruiting@example.com",
      "receivedAt": "2026-10-17T15:04:05Z",
      "forwardedAt": "2026-10-17T15:04:09Z",
      "outcome": "interview",
      "member": {
        "id": "00000000-0000-4000-8000-000000000001",
        "firstName": "Alex",
        "lastName": "Morgan"
      },
      "application": {
        "id": 48101,
        "company": "Example Labs",
        "title": "Operations Analyst",
        "status": "interview"
      }
    }
  ],
  "total": 143,
  "last24h": 9,
  "nextCursor": "25"
}
```

### Activity graph (rolling window)

`GET /enterprise/activity`

**Required scopes:** users:read, applications:read

The original form: replace 7d with 24h, 14d, or 30d for per-member bucketed submission counts over a rolling window. Prefer interval for the cohort chart.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `range` | query | `string` | Optional | 24h, 7d (default), 14d, or 30d. Hourly buckets for 24h; daily buckets otherwise. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/activity?range=7d" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "range": "7d",
  "buckets": [
    "2026-09-23T12:00:00Z",
    "2026-09-24T12:00:00Z",
    "2026-09-25T12:00:00Z",
    "2026-09-26T12:00:00Z",
    "2026-09-27T12:00:00Z",
    "2026-09-28T12:00:00Z",
    "2026-09-29T12:00:00Z"
  ],
  "endAt": "2026-09-30T12:00:00Z",
  "members": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "name": "Alex Morgan",
      "email": "alex@example.com",
      "values": [
        2,
        0,
        4,
        1,
        3,
        0,
        2
      ]
    }
  ]
}
```

### Member profile, recent applications, and emails

`GET /enterprise/users/$JOBBIE_MEMBER_ID/overview`

**Required scopes:** users:read, applications:read, emails:read

The member ID is a seat membership ID. Only permitted organization activity and job-related emails are returned.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/overview" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "user": {
    "id": "member_example",
    "managed": true
  },
  "applications": [],
  "applicationTotal": 0,
  "emails": []
}
```

### Member application history

`GET /enterprise/users/$JOBBIE_MEMBER_ID/applications`

**Required scopes:** applications:read

limit is 1–100 (default 10). Follow nextCursor until null.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `limit` | query | `integer` | Optional | 1–100 applications per page; default 10. |
| `cursor` | query | `string` | Optional | Use nextCursor from the previous response. Stop when null. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications?limit=10" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "items": [],
  "total": 0,
  "nextCursor": null
}
```

### Application answers and timestamps

`GET /enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID`

**Required scopes:** applications:read

Returns application.answers, referenceUrl, recordedAt, startedAt, submittedAt, completedAt, resume and source fields. Missing historical values are null; saved answers can be incomplete.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_APPLICATION_ID` | path | `integer` | Required | Positive integer application ID returned by application history. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "memberId": "00000000-0000-4000-8000-000000000001",
  "application": {
    "id": 123,
    "company": "Example Company",
    "title": "Software Engineer",
    "status": "applied",
    "referenceUrl": "https://example.com/jobs/123",
    "recordedAt": "2026-09-30T11:03:00Z",
    "startedAt": "2026-09-30T11:00:00Z",
    "submittedAt": "2026-09-30T11:03:00Z",
    "completedAt": "2026-09-30T11:03:05Z",
    "answers": [
      {
        "label": "Are you authorized to work in the United States?",
        "answer": "Yes"
      }
    ],
    "answersState": "recorded"
  }
}
```

### Create managed seats

`POST /organizations/$JOBBIE_ORG_ID/users/managed/batch`

**Required scopes:** users:write

Create 1–100 new accounts atomically within purchased capacity. authorized must be true and represent applicant permission. expiresAt is required: every seat in the request ends on that date (a seat may name its own). The organization owner is emailed 7 days, 48 hours and 24 hours before a seat expires; when it expires Autopilot stops, the organization plan is withdrawn and the seat is released. Afterwards you can move a seat's end date later (Extend a seat); only Jobbie can shorten or remove a seat. No signup or verification-code email is sent. Personal applicant emails are allowed; existing accounts return 409 account_exists. Profile setup and application eligibility still apply.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `users` | body | `object[]` | Required | 1–100 new applicants. The entire batch must fit within available seats. |
| `users[].email` | body | `string` | Required | Valid applicant email, up to 254 characters. Personal email addresses are accepted. |
| `users[].externalId` | body | `string` | Required | Your identifier for the applicant; up to 120 characters, unique within the organization. |
| `users[].firstName / lastName` | body | `string` | Optional | Applicant names, up to 100 characters each. |
| `users[].authorized` | body | `boolean` | Required | Must be true. Confirms applicant permission to apply on their behalf. |
| `expiresAt` | body | `string` | Required | Seat end date for every seat in this request: YYYY-MM-DD (access through the end of that day, UTC) or an RFC 3339 timestamp. Must be in the future and within five years. Required unless every user carries its own expiresAt. |
| `users[].expiresAt` | body | `string` | Optional | Overrides the request-level expiresAt for one seat; same format. |
| `assignSeat` | body | `boolean` | Optional | false creates the members without a seat (membershipStatus unassigned): no expiresAt, no purchased seat used, no plan granted. Prepare their profile and resume, then seat them with Assign a seat. This is what the portal's Create Member does. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/managed/batch" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "expiresAt": "2027-03-31",
  "users": [
    {
      "email": "alex@example.com",
      "externalId": "employee-001",
      "firstName": "Alex",
      "lastName": "Morgan",
      "authorized": true
    }
  ]
}'
```

Response: HTTP 201

```json
{
  "memberIds": [
    "member_example"
  ],
  "status": "active",
  "managed": true,
  "verificationRequired": false
}
```

### Extend a seat

`PATCH /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat-expiry`

**Required scopes:** users:write

Move a seat's end date later, for example when a trial converts or a renewal is paid. Later only: an earlier date returns 409 seat_expiry_not_later, and the same date again returns 200 with extended false, so a retried payment event is safe. A seat that expired within the last 7 days comes back (reactivated true) with the application balance it held, if a purchased seat is free (409 seat_limit_exceeded otherwise); Autopilot stays off until you start it again. Seats that expired more than 7 days ago return 409 seat_lapsed_too_long and seats Jobbie deactivated return 409 seat_not_extendable: contact Jobbie. Extending a date does not add applications.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `expiresAt` | body | `string` | Required | The new end date, later than the current one: YYYY-MM-DD (access through the end of that day, UTC) or an RFC 3339 timestamp, within five years. Send no other field. |

Request:

```bash
curl --fail-with-body --request PATCH "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat-expiry" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "expiresAt": "2027-04-30"
}'
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "seatExpiresAt": "2027-04-30T23:59:59Z",
  "previousSeatExpiresAt": "2027-03-31T23:59:59Z",
  "extended": true,
  "reactivated": false
}
```

### Start Autopilot for members

`POST /organizations/$JOBBIE_ORG_ID/autopilot`

**Required scopes:** autopilot:run

Replace the example member ID with a membership ID from the dashboard. Supply 1–100 unique memberIds. Enables continuous Autopilot until paused, using existing member application allowances. Each selected member needs an active authorized seat, a ready resume, job preferences, an eligible plan, and remaining applications. Per-member blocked reasons are returned. Existing keys need a replacement with autopilot:run. Add autopilotMode to choose Standard or Max in the same request; without it each member keeps their current mode.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `memberIds` | body | `string[]` | Required | 1–100 unique membership UUIDs from the organization roster. |
| `enabled` | body | `boolean` | Required | true enables continuous Autopilot until paused. |
| `autopilotMode` | body | `string` | Optional | standard or max. Max tailors the resume to each posting before applying and needs the organization Monthly plan on the seat. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/autopilot" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "memberIds": [
    "00000000-0000-4000-8000-000000000001"
  ],
  "enabled": true
}'
```

Response: HTTP 200

```json
{
  "mode": "continuous",
  "items": [
    {
      "memberId": "00000000-0000-4000-8000-000000000001",
      "enabled": true,
      "status": "starting",
      "autopilotMode": "standard"
    }
  ]
}
```

### Pause Autopilot for members

`POST /organizations/$JOBBIE_ORG_ID/autopilot`

**Required scopes:** autopilot:run

Use the same endpoint with enabled: false. Pauses future dispatch for selected active seats. Applications already in flight may finish; submitted applications are not withdrawn.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `memberIds` | body | `string[]` | Required | 1–100 unique membership UUIDs from the organization roster. |
| `enabled` | body | `boolean` | Required | false pauses future dispatch for the selected members. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/autopilot" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "memberIds": [
    "00000000-0000-4000-8000-000000000001"
  ],
  "enabled": false
}'
```

Response: HTTP 200

```json
{
  "mode": "continuous",
  "items": [
    {
      "memberId": "00000000-0000-4000-8000-000000000001",
      "enabled": false,
      "status": "paused",
      "autopilotMode": "standard"
    }
  ]
}
```

### Switch members to Autopilot Max

`POST /organizations/$JOBBIE_ORG_ID/autopilot`

**Required scopes:** autopilot:run

Send autopilotMode without enabled to change the mode without starting or pausing anyone. Max writes a resume tailored to each posting before applying; Standard submits the member’s saved resume. Max needs an active organization Monthly plan on the seat: other seats return max_plan_required and are left unchanged. Indeed applications always use the saved resume. The change applies to applications that start after it. The member roster and profile responses report each member’s autopilotMode.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `memberIds` | body | `string[]` | Required | 1–100 unique membership UUIDs from the organization roster. |
| `autopilotMode` | body | `string` | Required here | max or standard. Either this or enabled must be present. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/autopilot" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "memberIds": [
    "00000000-0000-4000-8000-000000000001"
  ],
  "autopilotMode": "max"
}'
```

Response: HTTP 200

```json
{
  "mode": "continuous",
  "items": [
    {
      "memberId": "00000000-0000-4000-8000-000000000001",
      "enabled": false,
      "status": "paused",
      "autopilotMode": "max"
    }
  ]
}
```

### Read email branding

`GET /organizations/$JOBBIE_ORG_ID/email-settings`

**Required scopes:** organization:read

Employer mail for a member always arrives on their Jobbie application address, is recorded against the application, and is then forwarded to the member. These settings control how that forwarded copy is presented. activeFromAddress is the address forwards come from right now.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/email-settings" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "senderName": "Acme Careers",
  "effectiveSenderName": "Acme Careers",
  "fromAddress": "careers@acme.com",
  "activeFromAddress": "hello@jobbie.bot",
  "defaultFromAddress": "hello@jobbie.bot",
  "domain": "acme.com",
  "domainStatus": "pending",
  "records": [
    {
      "record": "DKIM",
      "type": "TXT",
      "name": "resend._domainkey",
      "value": "p=MIGfMA0GCSqGSIb3DQEB…",
      "status": "pending"
    },
    {
      "record": "SPF",
      "type": "MX",
      "name": "send",
      "value": "feedback-smtp.us-east-1.amazonses.com",
      "priority": 10,
      "status": "pending"
    },
    {
      "record": "SPF",
      "type": "TXT",
      "name": "send",
      "value": "v=spf1 include:amazonses.com ~all",
      "status": "pending"
    }
  ],
  "preview": {
    "from": "Workday via Acme Careers <hello@jobbie.bot>",
    "banner": "Forwarded by Acme Careers"
  }
}
```

### Set the sender name and From address

`PATCH /organizations/$JOBBIE_ORG_ID/email-settings`

**Required scopes:** organization:write

Forwards read “Workday via <senderName>” with a “Forwarded by <senderName>” banner. Setting fromAddress returns the DNS records to publish on that domain; forwards keep coming from Jobbie’s address until the domain verifies. Send an empty string to reset either field. A domain can belong to one organization, and personal mail providers are rejected.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `senderName` | body | `string` | Optional | Up to 60 characters on one line, without < > @ " or \. Empty uses the organization name. |
| `fromAddress` | body | `string` | Optional | An address on a domain your organization controls. Empty returns to Jobbie’s address. At least one field is required. |

Request:

```bash
curl --fail-with-body --request PATCH "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/email-settings" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "senderName": "Acme Careers",
  "fromAddress": "careers@acme.com"
}'
```

Response: HTTP 200

```json
{
  "senderName": "Acme Careers",
  "effectiveSenderName": "Acme Careers",
  "fromAddress": "careers@acme.com",
  "activeFromAddress": "hello@jobbie.bot",
  "defaultFromAddress": "hello@jobbie.bot",
  "domain": "acme.com",
  "domainStatus": "pending",
  "records": [
    {
      "record": "DKIM",
      "type": "TXT",
      "name": "resend._domainkey",
      "value": "p=MIGfMA0GCSqGSIb3DQEB…",
      "status": "pending"
    },
    {
      "record": "SPF",
      "type": "MX",
      "name": "send",
      "value": "feedback-smtp.us-east-1.amazonses.com",
      "priority": 10,
      "status": "pending"
    },
    {
      "record": "SPF",
      "type": "TXT",
      "name": "send",
      "value": "v=spf1 include:amazonses.com ~all",
      "status": "pending"
    }
  ],
  "preview": {
    "from": "Workday via Acme Careers <hello@jobbie.bot>",
    "banner": "Forwarded by Acme Careers"
  }
}
```

### Check From address verification

`POST /organizations/$JOBBIE_ORG_ID/email-settings/verify`

**Required scopes:** organization:write

Re-checks the DNS records. DNS changes can take up to 48 hours. Once domainStatus is verified, forwards come from your address; if the domain later stops verifying, mail is delivered from Jobbie’s address instead of being dropped.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/email-settings/verify" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "senderName": "Acme Careers",
  "effectiveSenderName": "Acme Careers",
  "fromAddress": "careers@acme.com",
  "activeFromAddress": "careers@acme.com",
  "defaultFromAddress": "hello@jobbie.bot",
  "domain": "acme.com",
  "domainStatus": "verified",
  "records": [
    {
      "record": "DKIM",
      "type": "TXT",
      "name": "resend._domainkey",
      "value": "p=MIGfMA0GCSqGSIb3DQEB…",
      "status": "verified"
    },
    {
      "record": "SPF",
      "type": "MX",
      "name": "send",
      "value": "feedback-smtp.us-east-1.amazonses.com",
      "priority": 10,
      "status": "verified"
    },
    {
      "record": "SPF",
      "type": "TXT",
      "name": "send",
      "value": "v=spf1 include:amazonses.com ~all",
      "status": "verified"
    }
  ],
  "preview": {
    "from": "Workday via Acme Careers <careers@acme.com>",
    "banner": "Forwarded by Acme Careers"
  }
}
```

### Deactivating a seat (locked)

`PATCH /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/membership`

**Required scopes:** users:write

Deactivating or reactivating a seat in place is always refused, by session or by API key. To take a seat away, release it (DELETE …/seat below): the member returns to the pool and can be seated again later. A seat's end date can be moved without Jobbie: see Extend a seat.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request PATCH "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/membership" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "status": "deactivated",
  "expectedVersion": 1
}'
```

Response: HTTP 403

```json
{
  "error": {
    "code": "seat_changes_locked",
    "message": "Seats can only be removed or reactivated by Jobbie. Contact Jobbie to change your seats."
  }
}
```

### Profile field options

`GET /organizations/$JOBBIE_ORG_ID/profile-options`

**Required scopes:** users:read

Read supported countries and preference/authorization values before onboarding managed seats.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/profile-options" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "catalogVersion": "2026-09-30",
  "resume": {
    "type": "PDF",
    "maxBytes": 10485760,
    "urlScheme": "https"
  },
  "salaryRange": {
    "currency": "USD",
    "period": "year",
    "defaultMin": 100000,
    "defaultMax": 250000
  }
}
```

### Read a managed member profile

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID`

**Required scopes:** users:read

Available to organization owners/admins for active, authorized, organization-managed seats. Save the ETag response header, including quotes, as JOBBIE_PROFILE_ETAG. Profile readiness covers resume and targeting; Start still checks the plan, allowance, and email setup.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "profileVersion": 0,
  "resumeStatus": "missing",
  "readyForAutopilot": false,
  "missingFields": [
    "resumeUrl",
    "jobPreferences.selectedTitles",
    "jobPreferences.selectedCountries"
  ],
  "profile": {
    "firstName": "Alex",
    "lastName": "Morgan"
  }
}
```

### Import a resume URL and update applicant information

`PATCH /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID`

**Required scopes:** users:write

Send the latest ETag in If-Match. resumeUrl must be a publicly downloadable HTTPS PDF, up to 10 MiB. Jobbie copies and parses it asynchronously; poll the returned operation before starting Autopilot. Supply all other information as structured fields. Omitted fields remain unchanged; supplied arrays replace old arrays. Empty or null social links stay unset even if the PDF contains old links. Field-only updates omit resumeUrl and return 200 immediately, also while Autopilot runs: the member's search restarts with the new criteria and the next run uses them. A resumeUrl import while Autopilot runs returns 409 autopilot_active; pause first. Every accepted update records the changed fields in the audit trail. Linked personal accounts are not writable through this API.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `If-Match` | header | `string` | Required | ETag returned by the most recent profile GET, e.g. "profile-0". |
| `resumeUrl` | body | `string` | Optional | HTTPS PDF URL for first import or replacement. Omit for field-only edits. |
| `email` | body | `string` | Optional | New account and contact email for the seat. Takes effect immediately with no verification mail; refused with 409 account_exists if another Jobbie account uses it. The seat's externalId, expiry and membership status cannot be changed. |
| `profile fields` | body | `object` | Optional | firstName, lastName, phone, address, links, jobPreferences, needsSponsorship, workAuthStatus, workAuthUnrestricted, securityClearance, languages, gender, orientation, race, veteranStatus, disabilityStatus, dateOfBirth (YYYY-MM-DD). Unknown/internal account fields are rejected. Including remote in jobPreferences.workplacePreference adds Remote to selectedStates automatically, so a remote-only seat needs no states. Send phone, a full address, and dateOfBirth where you can: responses list the empty ones in recommendedFields, and postings that ask for them fail for that seat. jobPreferences.salaryMin and salaryMax are annual USD figures: a profile saved with neither gets the default range 100000–250000, because forms that require a salary figure fail for a seat without one. A form that asks for a desired salary is answered with the top of the range the posting states, or salaryMax when it states no pay, and postings whose stated pay lies wholly outside the range are skipped. Send salaryMin 0 with salaryMax null to keep a seat with no salary preference. jobPreferences.requireStatedPay true additionally skips every posting whose pay Jobbie could not read, so the salary floor is always enforced; the default false lets postings that omit pay through. |

Request:

```bash
curl --fail-with-body --request PATCH "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "If-Match: $JOBBIE_PROFILE_ETAG" \
  --header "Content-Type: application/json" \
  --data '{
  "resumeUrl": "https://files.example.com/alex-resume.pdf",
  "firstName": "Alex",
  "lastName": "Morgan",
  "phone": "+12025550123",
  "address": {
    "street": "123 Example Street",
    "city": "New York",
    "state": "New York",
    "zip": "10001",
    "country": "United States"
  },
  "links": {
    "linkedin": "",
    "github": "",
    "portfolio": "",
    "additionalUrls": []
  },
  "needsSponsorship": false,
  "workAuthUnrestricted": true,
  "jobPreferences": {
    "selectedTitles": [
      "Software Engineer"
    ],
    "selectedCountries": [
      "United States"
    ],
    "workplacePreference": [
      "remote"
    ],
    "salaryMin": 90000,
    "salaryMax": 150000
  }
}'
```

Response: HTTP 202

```json
{
  "memberId": "member_example",
  "operationId": "operation_example",
  "status": "queued",
  "resumeStatus": "queued",
  "profileVersion": 0,
  "autopilotEnabled": false
}
```

### Upload a resume PDF

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/resume`

**Required scopes:** users:write

The same import as resumeUrl, with the file sent directly: multipart/form-data with the PDF in field "resume", up to 10 MiB, and the latest ETag in If-Match. No other field changes. Jobbie stages the file under the member's own storage, parses it asynchronously and removes the staged copy when the operation finishes; poll the returned operation before starting Autopilot. This is the request behind the portal's Upload resume button.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `If-Match` | header | `string` | Required | ETag returned by the most recent profile GET, e.g. "profile-0". |
| `resume` | body | `file` | Required | multipart/form-data part holding the PDF (checked by content, not file name). 413 resume_too_large above 10 MiB; 422 resume_type_unsupported for anything that is not a PDF. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/resume" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "If-Match: $JOBBIE_PROFILE_ETAG" \
  --form "resume=@./alex-resume.pdf;type=application/pdf"
```

Response: HTTP 202

```json
{
  "memberId": "member_example",
  "operationId": "operation_example",
  "status": "queued",
  "resumeStatus": "queued",
  "profileVersion": 0,
  "autopilotEnabled": false
}
```

### Assign a seat to a member

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat`

**Required scopes:** users:write

Move a member created without a seat (assignSeat false, membershipStatus unassigned) into one of your purchased seats. From then on the member is exactly what a freshly created seat is: active, ending on expiresAt, carrying the organization plan, and reminded 7 days, 48 hours and 24 hours before the date. 409 no_open_seats when every purchased seat is taken, 409 seat_not_assignable for a member who already holds or held a seat. The response is the member record. Releasing the seat again is DELETE on the same path. This is what the Seats page's member selector does.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `expiresAt` | body | `string` | Required | The seat's end date: YYYY-MM-DD (access through the end of that day, UTC) or an RFC 3339 timestamp, in the future and within five years. Send no other field. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "expiresAt": "2027-03-31"
}'
```

Response: HTTP 200

```json
{
  "id": "member_example",
  "email": "alex@example.com",
  "firstName": "Alex",
  "lastName": "Morgan",
  "membershipStatus": "active",
  "seatExpiresAt": "2027-03-31T23:59:59Z",
  "planName": "Monthly",
  "applicationsRemaining": 1000
}
```

### Release a seat

`DELETE /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat`

**Required scopes:** users:write

Takes the seat away from an active (or expired) member: they return to the pool (membershipStatus unassigned, no end date), the seat opens up, and the organization plan is revoked from them as on deactivation. Refused with 409 autopilot_running while the member's Autopilot is on — stop it first; a run is never transferred. 409 no_seat for a member who holds none. The response is the member record. This is Remove member in the Seats page's selector; replacing a member is a release followed by an assign.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/seat" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "id": "member_example",
  "email": "alex@example.com",
  "firstName": "Alex",
  "lastName": "Morgan",
  "membershipStatus": "unassigned",
  "seatExpiresAt": null
}
```

### List a member's profiles

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles`

**Required scopes:** users:read

A member can keep several resume profiles; the active one is what searches and Autopilot use (the Seats page's Active Profile selector). latest marks the most recently added profile. A member with only a legacy resume reads as one profile named Resume.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "activeIndex": 0,
  "items": [
    {
      "index": 0,
      "name": "Resume",
      "createdAt": "2026-08-12T15:00:00Z",
      "isDefault": true,
      "hasResume": true,
      "targetRoles": [],
      "targetingEnabled": false,
      "latest": false,
      "active": true
    },
    {
      "index": 1,
      "name": "Design leadership",
      "createdAt": "2026-09-28T10:30:00Z",
      "isDefault": false,
      "hasResume": true,
      "targetRoles": [
        "Design Lead"
      ],
      "targetingEnabled": true,
      "latest": true,
      "active": false
    }
  ]
}
```

### Add a profile

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles`

**Required scopes:** users:write

Creates an empty profile with this name; upload a resume for it afterwards. 409 profile_limit at the cap, 422 for a blank name. The response carries the new index and the full list.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `name` | body | `string` | Required | The profile's name, up to 80 characters. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Design leadership"
}'
```

Response: HTTP 201

```json
{
  "index": 1,
  "activeIndex": 0,
  "items": [
    {
      "index": 0,
      "name": "Resume",
      "active": true,
      "latest": false
    },
    {
      "index": 1,
      "name": "Design leadership",
      "active": false,
      "latest": true
    }
  ]
}
```

### Set a member's active profile

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX/activate`

**Required scopes:** users:write

Switches which profile the member's search and Autopilot use. Refused with 409 autopilot_running while Autopilot is on, 409 resume_required when the profile has no resume, 404 for an unknown index. Changing the active profile never starts Autopilot.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_PROFILE_INDEX` | path | `integer` | Required | Zero-based profile index from the member's profile list. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX/activate" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "activeIndex": 1,
  "items": [
    {
      "index": 0,
      "name": "Resume",
      "active": false,
      "latest": false
    },
    {
      "index": 1,
      "name": "Design leadership",
      "active": true,
      "latest": true
    }
  ]
}
```

### Cohort mailbox

`GET /enterprise/mailbox`

**Required scopes:** emails:read

Every email received at the organization members' Jobbie application addresses, newest first, with the folder (inbox, sent, drafts, trash), member, read status, date window (7d, 30d, 90d, all), text search (sender, subject, linked company — across all matching mail, not only the page) and category (follow_up, assessment, interview, offer, rejected; hideRejections=1 drops rejections) combined on the server. unread, connectedMailboxes and folderCounts are organization-wide; total and categoryCounts follow the active filters. kind is inbound, reply, composed or draft. Members only ever see their own mail. This is the portal's Inbox page.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `folder` | query | `string` | Optional | inbox (default), sent, drafts or trash. |
| `member` | query | `string` | Optional | all (default) or a membership ID. |
| `read` | query | `string` | Optional | all (default), unread or read. |
| `since` | query | `string` | Optional | 7d, 30d (default), 90d or all. |
| `q` | query | `string` | Optional | Case-insensitive text matched against the sender, subject and linked company; up to 200 characters. |
| `category` | query | `string` | Optional | all (default), follow_up, assessment, interview, offer or rejected. |
| `hideRejections` | query | `string` | Optional | 1 drops rejections from the result. |
| `cursor` | query | `string` | Optional | nextCursor from the previous page. |
| `limit` | query | `integer` | Optional | 1–100, default 50. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/mailbox?folder=inbox&member=all&read=all&since=30d&q=&category=all&limit=50" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "id": "7b0b7c7e-0f8e-4d5b-9c2a-3d1f5a6e8b01",
      "kind": "inbound",
      "from": "no-reply@us.greenhouse-mail.io",
      "to": "applicant-12@mail.jobbie.bot",
      "subject": "Thank you for applying to The Weather Company",
      "preview": "Jamie, Thanks for applying to The Weather Company. Your application has been received and…",
      "receivedAt": "2026-10-17T20:31:00Z",
      "read": false,
      "outcome": null,
      "followUp": false,
      "member": {
        "id": "member_example",
        "firstName": "Jamie",
        "lastName": "Lee"
      },
      "application": {
        "id": 48213,
        "company": "The Weather Company",
        "title": "Product Designer",
        "status": "applied"
      }
    }
  ],
  "total": 594,
  "unread": 277,
  "connectedMailboxes": 42,
  "folderCounts": {
    "inbox": 594,
    "sent": 23,
    "drafts": 2,
    "trash": 5
  },
  "categoryCounts": {
    "followUp": 19
  },
  "nextCursor": "50"
}
```

### Read a cohort email

`GET /enterprise/mailbox/inbound/$JOBBIE_EMAIL_ID`

**Required scopes:** emails:read

The full message: the list fields plus textBody and htmlBody. Render htmlBody in a sandboxed frame. Opening an unread inbound message marks it read.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_EMAIL_ID` | path | `UUID` | Required | Message ID from the cohort mailbox list (the item's id, with its kind in the path). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/mailbox/inbound/$JOBBIE_EMAIL_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "id": "7b0b7c7e-0f8e-4d5b-9c2a-3d1f5a6e8b01",
  "kind": "inbound",
  "from": "no-reply@us.greenhouse-mail.io",
  "subject": "Thank you for applying to The Weather Company",
  "receivedAt": "2026-10-17T20:31:00Z",
  "read": true,
  "textBody": "Jamie, Thanks for applying to The Weather Company…",
  "htmlBody": "<p>Jamie, Thanks for applying…</p>",
  "member": {
    "id": "member_example",
    "firstName": "Jamie",
    "lastName": "Lee"
  }
}
```

### Mark filtered emails as read

`POST /enterprise/mailbox/read`

**Required scopes:** emails:write

Marks every unread inbox message matching the given filters as read — the whole matching set, not only the page the list has loaded. The body takes the same fields as the mailbox query. Returns the number updated and the organization-wide unread count that remains.

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/enterprise/mailbox/read" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "folder": "inbox",
  "member": "all",
  "read": "all",
  "since": "30d",
  "q": "",
  "category": "all",
  "hideRejections": false
}'
```

Response: HTTP 200

```json
{
  "updated": 41,
  "unread": 236
}
```

### Organization applications board

`GET /enterprise/board`

**Required scopes:** users:read, applications:read

The member's own applications board seen from the organization: every record a seat has made, with the fields the Jobbie app shows on a card (resume sent, Verified and Fit badges, match score, saved answers, live step) and the membership it belongs to, newest first. member is all (default) or a membership ID; member sessions always get their own seat. A cohort read stops at 2,000 records (truncated is then true) — read one member for the rest. This is the request behind the portal's Applications page.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `member` | query | `string` | Optional | all (default) or a membership ID. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/board?member=all" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "member": "all",
  "truncated": false,
  "items": [
    {
      "id": 48213,
      "title": "Operations Analyst",
      "company": "Example Labs",
      "appliedDate": "2026-10-17T17:58:02Z",
      "statusUpdatedAt": "2026-10-17T17:58:02Z",
      "status": "applied",
      "url": "https://boards.example.com/jobs/48213",
      "resumeAvailable": true,
      "resumeDisplayName": "Alex Morgan - Analyst.pdf",
      "resumeVerified": true,
      "resumeFitScore": 72,
      "match_percent": 87,
      "matched_skills": [
        "SQL",
        "Excel"
      ],
      "answers": [
        {
          "label": "Authorized to work in the US?",
          "answer": "Yes"
        }
      ],
      "member": {
        "id": "member_example",
        "firstName": "Alex",
        "lastName": "Morgan",
        "email": "alex@example.com"
      }
    }
  ]
}
```

### Move an application to another stage

`POST /enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/status`

**Required scopes:** applications:write

The same move as dragging the card on the board: between applied, assessment, interview, offer and rejected in any direction. in_progress and failed belong to the apply flow and cannot be set or left by hand. The stage is stamped as a person's decision, so employer email never moves that application again. A refused move answers 400 application_action_refused with the reason.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_APPLICATION_ID` | path | `integer` | Required | Positive integer application ID returned by application history. |
| `status` | body | `string` | Required | applied, assessment, interview, offer or rejected. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/status" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "status": "interview"
}'
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "status": "interview"
}
```

### Stop an application in progress

`POST /enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/cancel`

**Required scopes:** applications:write

Stops an application Jobbie is making right now. 200 result cancelled when it stopped before submission; 409 with result already_submitted (or the final status) when the apply finished first — the record then shows what actually happened. No allowance is refunded by this call.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_APPLICATION_ID` | path | `integer` | Required | Positive integer application ID returned by application history. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/cancel" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "success": true,
  "result": "cancelled",
  "status": "failed",
  "reason": "cancelled_by_user"
}
```

### Open the resume sent with an application

`GET /enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/resume`

**Required scopes:** applications:read

The PDF that went out with that application, as application/pdf inline. 404 when the application has no resume on file (an application the member made outside Jobbie, or one that failed before a resume was prepared).

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_APPLICATION_ID` | path | `integer` | Required | Positive integer application ID returned by application history. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications/$JOBBIE_APPLICATION_ID/resume" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

No response body.

### Record an application made outside Jobbie

`POST /enterprise/users/$JOBBIE_MEMBER_ID/applications/mark-applied`

**Required scopes:** applications:write

Adds a job the member applied to themselves to their board (source external): nothing is submitted, no allowance is used, and the posting stops appearing in their feed. Any http(s) link is accepted; title and company are filled in for the boards Jobbie can read. A link already on the board is a no-op; a previously failed Jobbie attempt flips to applied.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `url` | body | `string` | Required | The posting the member applied to. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/enterprise/users/$JOBBIE_MEMBER_ID/applications/mark-applied" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "url": "https://www.linkedin.com/jobs/view/1234567890"
}'
```

Response: HTTP 200

```json
{
  "memberId": "member_example",
  "success": true
}
```

### Delete an inactive member profile

`DELETE /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX`

**Required scopes:** users:write

Read the profiles list and send its ETag in If-Match. Only owners, admins, and scoped organization API keys can delete. The active/only profile is protected: select another active profile first. Autopilot, active resume imports, or pending applications using this profile block deletion (409). A stale list returns 412; reload and choose the profile again. Remaining profile indexes and pending references are compacted together; member identity, other resumes, and historical applications remain intact.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |
| `JOBBIE_PROFILE_INDEX` | path | `integer` | Required | Zero-based profile index from the member's profile list. |
| `If-Match` | header | `string` | Required | ETag from the latest profiles list. |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/profiles/$JOBBIE_PROFILE_INDEX" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "activeIndex": 0,
  "items": [
    {
      "index": 0,
      "name": "Resume",
      "active": true,
      "hasResume": true
    }
  ]
}
```

### Read member Indeed connection

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed`

**Required scopes:** users:read

Owner/admin access to an authorized organization-managed member is required. Returns connection status and account email only. An expired connection reports connected: false with the saved email.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "connected": false,
  "email": ""
}
```

### Send member Indeed verification code

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed`

**Required scopes:** users:write

Optional connection. Indeed sends a code to this account email. Pending codes are isolated by organization, member, and requesting administrator/API key. Use the same identity to verify. Pause Autopilot before making changes.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "email": "member@example.com"
}'
```

Response: HTTP 200

```json
{
  "success": true,
  "email": "member@example.com"
}
```

### Verify member Indeed account

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed/verify`

**Required scopes:** users:write

Stores the verified connection for the selected member. No passwords or cookies are returned. Invalid or expired codes return 400; request a new code when expired. A 428 with code indeed_phone_check_retry needs a fresh code; another phone check requires verifying a phone number on Indeed. Provider throttling returns 429. Autopilot, in-flight applications, and resume imports block persistence (409). An explicit saved board selection is extended to include Indeed and the profile ETag advances.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed/verify" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "email": "member@example.com",
  "code": "123456"
}'
```

Response: HTTP 200

```json
{
  "connected": true,
  "email": "member@example.com"
}
```

### Disconnect member Indeed account

`DELETE /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed`

**Required scopes:** users:write

Removes only the selected member’s Jobbie connection. Does not delete the Indeed account. Requires paused Autopilot and no active execution/import; revoked member authorization prevents changes.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/indeed" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "connected": false,
  "email": ""
}
```

### Read member LinkedIn connection

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin`

**Required scopes:** users:read, linkedin:read

Owner/admin access to an authorized organization-managed member is required. status is disconnected, connecting, needs_code, connected, or error. While connecting, poll every 3–5 seconds until authDeadline. needs_code means LinkedIn sent the member a verification code: submit it with Verify member LinkedIn sign-in. pending and accepted count the connection requests sent from this seat. No cookies, passwords, or LinkedIn identifiers are ever returned.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "status": "connected",
  "email": "member@example.com",
  "authPhase": "connected",
  "authDeadline": "2026-10-23T18:05:00Z",
  "authError": "",
  "confirmedAt": "2026-10-23T18:01:12Z",
  "pending": 3,
  "accepted": 7
}
```

### Sign a member in to LinkedIn

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin`

**Required scopes:** users:write, linkedin:write

Starts an asynchronous sign-in with the member’s own LinkedIn email and password and answers 202 straight away; read the connection until it settles. Send only these two fields as application/json (4 KiB maximum; unknown fields return 400). linkedin:write is a separate scope that no earlier key has: issue a dedicated, short-lived key for this and keep it server-side. Jobbie uses the password once, in memory, and never stores, logs, or returns it; only the encrypted LinkedIn session is kept. Limits: 5 sign-ins per member and 60 per organization per hour (429 with Retry-After). Command Center support sessions cannot call this. Every attempt is written to your organization’s audit log without the password. Get the member’s consent first; members can instead link LinkedIn themselves from Network in the Jobbie app.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "email": "member@example.com",
  "password": "the-member’s-LinkedIn-password"
}'
```

Response: HTTP 202

```json
{
  "status": "connecting",
  "authPhase": "preparing",
  "authDeadline": "2026-10-23T18:05:00Z"
}
```

### Verify member LinkedIn sign-in

`POST /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/verify`

**Required scopes:** users:write, linkedin:write

Only when the connection reads needs_code. Send the 4–8 digit code LinkedIn sent the member, as the only field. Answers 202; read the connection again until it is connected or error. A 409 means the verification session expired: start a new sign-in. Limited to 10 codes per member per hour.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/verify" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "code": "123456"
}'
```

Response: HTTP 202

```json
{
  "status": "connecting",
  "authPhase": "verifying",
  "authDeadline": "2026-10-23T18:09:00Z"
}
```

### List member LinkedIn connection requests

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/connections`

**Required scopes:** users:read, linkedin:read

The people this seat has sent connection requests to, pending or accepted, with the application each was found for. Empty when no LinkedIn account is connected.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin/connections" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "name": "Alex Chen",
      "headline": "Engineering Manager at Example",
      "profileUrl": "https://www.linkedin.com/in/example",
      "status": "accepted",
      "job": {
        "url": "https://jobs.example.com/123",
        "title": "Software Engineer",
        "company": "Example"
      },
      "invitedAt": "2026-10-22T15:00:00Z",
      "acceptedAt": "2026-10-23T09:12:00Z"
    }
  ]
}
```

### Disconnect member LinkedIn account

`DELETE /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin`

**Required scopes:** users:write, linkedin:write

Removes the seat’s stored LinkedIn session. It does not delete or sign out of the LinkedIn account and does not withdraw requests already sent. Releasing a managed seat removes it as well.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/linkedin" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "status": "disconnected"
}
```

### Read a member's job board password

`GET /organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/board-password`

**Required scopes:** users:read, credentials:read

The password Jobbie generated for the member’s Workday and SuccessFactors candidate accounts; sign in to those accounts with the member’s Jobbie address. password is null until Jobbie creates the member’s first job board account (reading never creates one). Owner/admin access to an authorized organization-managed member is required. credentials:read is a separate scope that no earlier key has: issue a dedicated key for this and keep it server-side. Every successful read is written to your organization’s audit log (without the password), and the response is sent with Cache-Control: no-store. Jobbie support can read it only in a “Work on their behalf” session, and those reads are logged as Jobbie support.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_MEMBER_ID` | path | `UUID` | Required | Membership UUID from the organization roster (not the personal account ID). |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/users/$JOBBIE_MEMBER_ID/board-password" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "password": "example-only-Passw0rd!Jb1"
}
```

### Check resume import status

`GET /organizations/$JOBBIE_ORG_ID/operations/$JOBBIE_OPERATION_ID`

**Required scopes:** users:read

Poll until succeeded or failed; queued/running imports block profile edits and Autopilot. On success, read the profile again for its new ETag and readiness. On failure, errorCode explains the issue; correct the URL/input and retry using the current profile ETag. Download/parse failures preserve the previous profile. Terminal operation responses never reveal the source URL.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_OPERATION_ID` | path | `UUID` | Required | Operation UUID returned by a resume URL update. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/operations/$JOBBIE_OPERATION_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "operationId": "operation_example",
  "memberId": "member_example",
  "status": "succeeded",
  "errorCode": null,
  "createdAt": "2026-09-30T12:00:00Z",
  "completedAt": "2026-09-30T12:00:30Z"
}
```

## Pagination

Application lists accept `limit` (1–100, default 10) and return `nextCursor`. Pass it back as `cursor` and continue until it is null. Keep the same filters while paginating dashboard members or organization-wide applications.

## Webhooks

Jobbie sends a signed `POST` to your HTTPS endpoint when a member's application is submitted or an employer replies with an interview, offer, or rejection. Endpoints are managed in the portal under **Webhooks** or with the requests below (`webhooks:read`, `webhooks:write`). The signing secret (`whsec_…`) is shown once.

### Events

| Event | Sent when |
| --- | --- |
| `application.submitted` | An application was submitted to the employer. |
| `application.interview` | An employer email was recognized as an interview invitation. |
| `application.offer` | An employer email was recognized as an offer. |
| `application.rejected` | An employer email was recognized as a rejection. |
| `application.failed` | An application attempt ended without being submitted; data.application.failureReason says why. |
| `webhook.test` | Sent only when you choose Send test. It needs no subscription and is never retried. |

Events are sent only for applications made through an organization seat. Interview, offer, and rejection events come from employer emails received at the member's Jobbie application address.

### Event body

The same event sent to two endpoints, or retried, keeps the same `id`. `data.member.id` and `data.application.id` match the application requests above. Ignore fields you do not recognize.

```json
{
  "id": "6f1f2a54-1c5e-4a8e-9f0b-2f6f1f0f4c11",
  "type": "application.interview",
  "createdAt": "2026-10-01T15:04:05.120Z",
  "organizationId": "00000000-0000-4000-8000-000000000001",
  "data": {
    "application": {
      "id": 123,
      "company": "Example Company",
      "title": "Operations Analyst",
      "status": "interview",
      "previousStatus": "applied",
      "referenceUrl": "https://jobs.example.com/postings/123",
      "appliedAt": "2026-09-29T18:22:10Z",
      "failureReason": null
    },
    "member": {
      "id": "00000000-0000-4000-8000-000000000010",
      "externalId": "employee-001",
      "email": "alex@example.com",
      "firstName": "Alex",
      "lastName": "Morgan"
    }
  }
}
```

### Request headers

| Header | Value |
| --- | --- |
| `Jobbie-Signature` | t=<unix seconds>,v1=<hex HMAC-SHA256>. Verify it before trusting the body. |
| `Jobbie-Event` | The event type, the same value as type in the body. |
| `Jobbie-Delivery` | Delivery UUID. It is the same on every retry of that delivery. |
| `Content-Type` | application/json |
| `User-Agent` | Jobbie-Webhooks/1.0 |

### Verify the signature

Compute an HMAC-SHA256 of `<t>.<raw request body>` with your signing secret and compare it with `v1` in constant time. Reject requests whose `t` is more than five minutes old. Use the raw bytes exactly as received.

```javascript
import crypto from 'node:crypto';
import express from 'express';

const app = express();
const secret = process.env.JOBBIE_WEBHOOK_SECRET;

// Verify against the raw bytes: parse the JSON only after the check passes.
app.post('/webhooks/jobbie', express.raw({ type: 'application/json' }), (req, res) => {
  const header = req.get('Jobbie-Signature') || '';
  const parts = Object.fromEntries(header.split(',').map((part) => part.split('=')));
  const expected = crypto.createHmac('sha256', secret).update(`${parts.t}.`).update(req.body).digest('hex');
  const valid = parts.v1?.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected))
    && Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  if (!valid) return res.status(400).end();

  const event = JSON.parse(req.body);
  // Queue the work and answer quickly; skip event.id values you have already handled.
  res.status(204).end();
});
```

```python
import hashlib, hmac, json, os, time
from flask import Flask, abort, request

app = Flask(__name__)
secret = os.environ["JOBBIE_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/jobbie")
def jobbie_webhook():
    parts = dict(p.split("=", 1) for p in request.headers.get("Jobbie-Signature", "").split(",") if "=" in p)
    body = request.get_data()  # raw bytes, before any JSON parsing
    expected = hmac.new(secret, parts.get("t", "").encode() + b"." + body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(parts.get("v1", ""), expected) or abs(time.time() - int(parts.get("t", 0))) > 300:
        abort(400)
    event = json.loads(body)
    # Queue the work and answer quickly; skip event["id"] values you have already handled.
    return "", 204
```

### Retries and failures

Answer with any `2xx` within 10 seconds and do slow work afterwards. Anything else is retried after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours, 12 hours, and 24 hours (eight attempts over about two days). An endpoint that fails every delivery for three days is disabled; fix it, send a test, then resume it. Events can repeat or arrive out of order, so store handled event `id` values. Endpoints must be public `https://` on port 443; redirects are not followed.

### List webhook endpoints

`GET /organizations/$JOBBIE_ORG_ID/webhooks`

**Required scopes:** webhooks:read

Returns every endpoint with its status and last delivery times, plus the event types you can subscribe to. Signing secrets are never returned here.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000020",
      "organizationId": "org_example",
      "url": "https://example.com/webhooks/jobbie",
      "description": "CRM sync",
      "events": [
        "application.interview",
        "application.offer",
        "application.rejected"
      ],
      "status": "active",
      "createdAt": "2026-10-01T12:00:00Z",
      "failingSince": null,
      "lastSuccessAt": null,
      "lastFailureAt": null
    }
  ],
  "events": [
    "application.submitted",
    "application.failed",
    "application.interview",
    "application.offer",
    "application.rejected"
  ]
}
```

### Create a webhook endpoint

`POST /organizations/$JOBBIE_ORG_ID/webhooks`

**Required scopes:** webhooks:write, users:read, applications:read

Save secret when it is returned: it is shown once and signs every request to this endpoint. An organization can have up to 10 endpoints. The key also needs users:read and applications:read because events carry member and application data.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `url` | body | `string` | Required | An https:// address on port 443 that is reachable from the public internet. No credentials or fragment in the URL. |
| `events` | body | `string[]` | Required | One or more of application.submitted, application.failed, application.interview, application.offer, application.rejected. |
| `description` | body | `string` | Optional | A label for your own reference, up to 120 characters. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "url": "https://example.com/webhooks/jobbie",
  "description": "CRM sync",
  "events": [
    "application.interview",
    "application.offer",
    "application.rejected"
  ]
}'
```

Response: HTTP 201

```json
{
  "webhook": {
    "id": "00000000-0000-4000-8000-000000000020",
    "organizationId": "org_example",
    "url": "https://example.com/webhooks/jobbie",
    "description": "CRM sync",
    "events": [
      "application.interview",
      "application.offer",
      "application.rejected"
    ],
    "status": "active",
    "createdAt": "2026-10-01T12:00:00Z",
    "failingSince": null,
    "lastSuccessAt": null,
    "lastFailureAt": null
  },
  "secret": "whsec_example_shown_once"
}
```

### Update, pause, or resume a webhook endpoint

`PATCH /organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID`

**Required scopes:** webhooks:write, users:read, applications:read

Send only the fields to change. Setting status to active also re-enables an endpoint Jobbie disabled after repeated failures. Events that happen while an endpoint is paused or disabled are not sent later.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_WEBHOOK_ID` | path | `UUID` | Required | Webhook endpoint UUID returned when listing or creating endpoints. |
| `status` | body | `string` | Optional | active or paused. |
| `events` | body | `string[]` | Optional | Replaces the subscribed event types. |
| `url` | body | `string` | Optional | A new https:// address. The signing secret does not change. |
| `description` | body | `string` | Optional | Up to 120 characters. |

Request:

```bash
curl --fail-with-body --request PATCH "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "status": "paused"
}'
```

Response: HTTP 200

```json
{
  "id": "00000000-0000-4000-8000-000000000020",
  "organizationId": "org_example",
  "url": "https://example.com/webhooks/jobbie",
  "description": "CRM sync",
  "events": [
    "application.interview",
    "application.offer",
    "application.rejected"
  ],
  "status": "paused",
  "createdAt": "2026-10-01T12:00:00Z",
  "failingSince": null,
  "lastSuccessAt": null,
  "lastFailureAt": null
}
```

### Send a test event

`POST /organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/test`

**Required scopes:** webhooks:write

Sends one signed webhook.test event immediately and reports what your server answered. Works on paused and disabled endpoints so you can check a fix before resuming. A failed test is not retried.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_WEBHOOK_ID` | path | `UUID` | Required | Webhook endpoint UUID returned when listing or creating endpoints. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/test" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "deliveryId": "00000000-0000-4000-8000-000000000030",
  "delivered": true,
  "responseStatus": 200,
  "errorCode": null
}
```

### List recent deliveries

`GET /organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/deliveries`

**Required scopes:** webhooks:read

Newest first, kept for 30 days. status is pending (queued or waiting to retry), delivered, or failed (all attempts used). errorCode is http_<status>, timeout, dns_failed, tls_failed, connection_failed, or blocked_address. Payloads are not included.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_WEBHOOK_ID` | path | `UUID` | Required | Webhook endpoint UUID returned when listing or creating endpoints. |
| `limit` | query | `integer` | Optional | 1–100, default 25. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID/deliveries?limit=25" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000030",
      "eventId": "6f1f2a54-1c5e-4a8e-9f0b-2f6f1f0f4c11",
      "eventType": "application.interview",
      "status": "delivered",
      "attempts": 1,
      "responseStatus": 200,
      "errorCode": null,
      "createdAt": "2026-10-01T15:04:05Z",
      "lastAttemptAt": "2026-10-01T15:04:06Z",
      "nextAttemptAt": null,
      "deliveredAt": "2026-10-01T15:04:06Z"
    }
  ]
}
```

### Delete a webhook endpoint

`DELETE /organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID`

**Required scopes:** webhooks:write

Stops deliveries at once and removes the endpoint with its delivery log. Its signing secret stops being used.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_WEBHOOK_ID` | path | `UUID` | Required | Webhook endpoint UUID returned when listing or creating endpoints. |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/webhooks/$JOBBIE_WEBHOOK_ID" \
  --header "Authorization: Bearer $JOBBIE_API_KEY" \
  --header "Accept: application/json"
```

Response: HTTP 204

No response body.

## Account and API-key management (owner/admin session)

These requests need `JOBBIE_SESSION_TOKEN`, a session for the organization owner or an admin. An API key cannot authenticate them. Sessions last 14 days; treat the token like a password.

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/login" \
  --header "Content-Type: application/json" \
  --data '{"email":"you@yourcompany.com","password":"YOUR_PASSWORD"}'

# Response: {"token":"<session token>", ...}
export JOBBIE_SESSION_TOKEN="<session token>"
```

### Enroll an organization

`POST /organizations`

**Authentication:** Verified company owner session

Sign up and verify a company email in the portal first. Common personal email providers cannot enroll a company. Enrollment requires Jobbie approval before dashboard/API-key access.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | body | `string` | Required | Company name, 1–120 characters after trimming. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Example Company"
}'
```

Response: HTTP 201

```json
{
  "id": "org_example",
  "name": "Example Company",
  "status": "pending",
  "seatLimit": 0
}
```

### Check approval and access

`GET /enterprise/access`

**Authentication:** Signed-in session

Returns not_enrolled before enrollment, otherwise the organization status and your role.

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/enterprise/access" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "status": "pending",
  "organization": {
    "id": "org_example",
    "name": "Example Company",
    "logoUrl": ""
  },
  "role": "owner"
}
```

### Upload company profile picture

`POST /enterprise/company-logo`

**Authentication:** Organization owner/admin session

PNG or JPEG up to 2 MB. Use multipart field logo; let curl set its multipart Content-Type. Pending owners may upload.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `logo` | form | `file` | Required | PNG or JPEG, up to 2 MB. Send as multipart/form-data. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/enterprise/company-logo" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json" \
  --form "logo=@./company-logo.png"
```

Response: HTTP 200

```json
{
  "logoUrl": "data:image/png;base64,..."
}
```

### List API keys

`GET /organizations/$JOBBIE_ORG_ID/api-keys`

**Authentication:** Organization owner/admin session

Returns metadata and prefixes only; full secrets cannot be retrieved.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |

Request:

```bash
curl --fail-with-body --request GET "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/api-keys" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json"
```

Response: HTTP 200

```json
{
  "items": []
}
```

### Create an API key

`POST /organizations/$JOBBIE_ORG_ID/api-keys`

**Authentication:** Organization owner/admin session

Requires an active organization. Save secret once in your server secret store. expiresIn accepts 24h, 3d, 7d, 30d, or never (the key stays valid until revoked; its expiresAt is null). The older expiresInDays (1–365) still works when expiresIn is omitted; with neither, keys last 90 days. Request only the scopes needed.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `name` | body | `string` | Required | A descriptive key name, 1–80 characters after trimming. |
| `scopes` | body | `string[]` | Required | One or more unique permissions. All six available scopes are included in this example. |
| `expiresIn` | body | `string` | Optional | 24h, 3d, 7d, 30d, or never. A key issued with never has expiresAt null and stays valid until revoked. Defaults to 90 days when omitted. |

Request:

```bash
curl --fail-with-body --request POST "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/api-keys" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Reporting integration",
  "scopes": [
    "organization:read",
    "users:read",
    "applications:read",
    "emails:read",
    "users:write",
    "autopilot:run"
  ],
  "expiresIn": "30d"
}'
```

Response: HTTP 201

```json
{
  "key": {
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Reporting integration",
    "scopes": [
      "organization:read",
      "users:read",
      "applications:read",
      "emails:read",
      "users:write",
      "autopilot:run"
    ],
    "expiresAt": "2026-12-29T12:00:00Z"
  },
  "secret": "example_only_replace_with_the_returned_secret"
}
```

### Revoke an API key

`DELETE /organizations/$JOBBIE_ORG_ID/api-keys/$JOBBIE_KEY_ID`

**Authentication:** Organization owner/admin session

Create a replacement and update your integration before revoking the old key. Revocation takes effect on the next authenticated request.

| Field | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `JOBBIE_ORG_ID` | path | `UUID` | Required | Organization UUID returned after enrollment. |
| `JOBBIE_KEY_ID` | path | `UUID` | Required | API key UUID returned when listing or creating keys. |

Request:

```bash
curl --fail-with-body --request DELETE "https://api.jobbie.bot/v1/organizations/$JOBBIE_ORG_ID/api-keys/$JOBBIE_KEY_ID" \
  --header "Authorization: Bearer $JOBBIE_SESSION_TOKEN" \
  --header "Accept: application/json"
```

Response: HTTP 204

No response body.

## Errors and retries

| Status | Meaning |
| --- | --- |
| 400 | Malformed JSON or invalid query parameters |
| 401 | Invalid, expired, or revoked key; inactive organization |
| 403 | Missing scope or insufficient role |
| 404 | Member, application, or organization is outside your access |
| 409 | Seat limit, duplicate reservation, or stale version |
| 412 | Profile changed; read its latest ETag before retrying |
| 428 | Missing If-Match profile version |
| 422 | Invalid request fields |
| 429 | Request limit reached; respect Retry-After |
| 503 | Temporarily unavailable; retry with backoff |

POST requests do not support idempotency keys. After an ambiguous timeout, check the member roster before repeating an onboarding request. Never retry key creation automatically: its secret is returned only once.
