> ## Documentation Index
> Fetch the complete documentation index at: https://offstage.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To set up offstage cloud from a coding agent, read https://api.offstage.cloud/SKILL.md and follow it. The whole API guide is one file at https://api.offstage.cloud/llms.txt.

# Invite a member

> Adds an existing user whose email is verified to the team at once as a `member` (answering `{member}`), or records an invite (answering `{invite}`) that takes effect when that address is proven: by opening its verification link, resetting its password, or signing in with GitHub or Google. Signing up alone joins nothing. Owners only, once the owner has verified their email. Console session only: an API key gets 403 `console-only`. Organizations only: a personal account gets 403 `personal-team`. The address is emailed. An invite lasts a week; inviting the address again renews it.



## OpenAPI

````yaml /openapi.json post /v1/team/members
openapi: 3.1.0
info:
  title: offstage cloud API
  version: 0.1.0
  summary: Real Macs for AI agents and CI, over HTTP.
  description: >-
    macOS sandboxes driven one call at a time, and fire-and-forget CI tasks, on
    Apple silicon Macs running macOS 27.


    - **Auth.** `Authorization: Bearer sk_offstage_…` (a team API key; one made
    before 2026-10-29 starts with `oc_live_` and still works), or the console's
    `oc_session` cookie. Operations marked `x-console-only: true` take only the
    cookie; an API key gets 403 `console-only`. A cookie request that changes
    something must come from this origin.

    - **Errors.** Every failure is `{"error": {"code", "message", "fix"?,
    "requestId"}}`. Switch on `code`; `fix`, when present, says what to do. Any
    operation can also answer 500 `internal` (a bug; quote the `requestId`), and
    an unknown route is 404 `no-such-route`.

    - **Request ids.** Every response carries an `x-request-id` header, repeated
    as `requestId` in error bodies.

    - **Units.** Times are Unix milliseconds, and durations end in `Ms`. Money
    is US dollars as numbers, exact to the micro-dollar (`costUsd`).

    - **Ids** are prefixed: `sbx_` sandbox, `cmd_` command, `run_` agent run,
    `task_` task, `key_` API key, `req_` request, `team_`, `usr_`, `box_` (a
    fleet Mac), `inv_`.

    - **Lists** are newest first. Pass the previous page's `nextCursor` as
    `cursor`; it is null on the last page.

    - **Bodies.** JSON, except file writes, which send raw bytes. Request
    schemas with `additionalProperties: false` refuse an unknown field with 400
    `unknown-field`.

    - **Limits.** A team may send 120 requests a minute, whatever key or session
    it uses. Every request also counts against its client address: 600 a minute,
    and far fewer on the routes that need no credential (5 sign-ups an hour, 20
    sign-ins and 20 verifications a minute). Over a window is 429 `rate-limit`
    with a `Retry-After` header.

    - **Verification.** A new account's team can sign in and look around, but
    cannot create sandboxes, tasks or API keys (403 `email-unverified`) until
    its owner opens the link emailed at signup.

    - **Holds.** No request is held longer than about 50 s, so default client
    timeouts and 60 s proxy idle timeouts are fine, except large files: a write
    answers once its upload is done, and a read streams for as long as the Mac
    takes to send it.


    The prose reference, with examples, is
    `https://api.offstage.cloud/llms.txt`. The agent setup guide is
    `https://api.offstage.cloud/SKILL.md`.
servers:
  - url: https://api.offstage.cloud
security:
  - apiKey: []
  - consoleSession: []
tags:
  - name: Sandboxes
    description: >-
      A Mac slot (a macOS user account) held for you: run commands, move files,
      take screenshots.
  - name: Tasks
    description: >-
      Fire-and-forget macOS work: clone a public repo, run a command, collect
      artifacts.
  - name: Recordings
    description: >-
      What a gui sandbox or gui task showed and did, kept by the plane: live
      while it runs, a replay after. Open one in the console at `/r/{id}`.
  - name: Capacity
    description: What the fleet can take right now, and whether the plane is up.
  - name: Billing
    description: The price, usage, the bill, the budget and the card.
  - name: Account
    description: Signing in, the team, its members and its API keys.
  - name: GitHub
    description: >-
      GitHub Actions jobs on offstage Macs: connect an organization in the
      console, then `runs-on: offstage-macos`.
  - name: Secrets
    description: Write-only team credentials selected by workload name.
paths:
  /v1/team/members:
    post:
      tags:
        - Account
      summary: Invite a member
      description: >-
        Adds an existing user whose email is verified to the team at once as a
        `member` (answering `{member}`), or records an invite (answering
        `{invite}`) that takes effect when that address is proven: by opening
        its verification link, resetting its password, or signing in with GitHub
        or Google. Signing up alone joins nothing. Owners only, once the owner
        has verified their email. Console session only: an API key gets 403
        `console-only`. Organizations only: a personal account gets 403
        `personal-team`. The address is emailed. An invite lasts a week;
        inviting the address again renews it.
      operationId: inviteMember
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InviteRequest'
      responses:
        '201':
          description: The new member, or the invite.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InviteResult'
        '400':
          description: '`not-an-object`, or `bad-email`.'
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            `unauthorized`: no credential, an `Authorization` header that is not
            `Bearer …`, a value that is not an `sk_offstage_` (or older
            `oc_live_`) key, a revoked or unknown key, or a box token. The
            message says which.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            `console-only`: an API key may not do this; only a signed-in console
            session may. `forbidden`: the signed-in user is not an owner of the
            team, or the request came from another origin. `email-unverified`:
            the owner has not verified their email yet. `not-a-member`,
            `team-changed`: the session left the team while the request was in
            flight; nothing was changed. `personal-team`: a personal account
            invites nobody; create an organization.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            `already-member`: that email is already on this team.
            `too-many-invites`: a team may have 50 invites out at once.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - consoleSession: []
components:
  schemas:
    InviteRequest:
      type: object
      properties:
        email:
          type: string
      required:
        - email
      additionalProperties: true
    InviteResult:
      description: >-
        `{member}` when the email already had a verified account, which is now
        on the team; `{invite}` otherwise. `emailed` says whether a mail went
        out: at most one per address and organization every 10 minutes, however
        often the invite is renewed.
      oneOf:
        - type: object
          properties:
            member:
              $ref: '#/components/schemas/Member'
            emailed:
              type: boolean
              description: >-
                A mail went out with this call (false when one was sent in the
                last 10 minutes, or sending failed).
          required:
            - member
            - emailed
          additionalProperties: false
        - type: object
          properties:
            invite:
              $ref: '#/components/schemas/PendingInvite'
            emailed:
              type: boolean
              description: >-
                A mail went out with this call (false when one was sent in the
                last 10 minutes, or sending failed).
          required:
            - invite
            - emailed
          additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: >-
                Stable and machine-readable, like `sandbox-closed`. Switch on
                this, not on the message.
            message:
              type: string
              description: What went wrong, for a person.
            fix:
              type: string
              description: What to do about it, when there is something to do.
            requestId:
              type: string
              description: >-
                The same as the `x-request-id` header. Quote it when asking for
                help.
              pattern: ^req_
          required:
            - code
            - message
            - requestId
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        The one error envelope: every 4xx and 5xx the plane itself sends. A
        proxy in front of it may send a 5xx whose body is not JSON.
      examples:
        - error:
            code: sandbox-closed
            message: sandbox sbx_mh3k2f9aQ1xYz0aBcDeFgHiJ is closed (idle)
            fix: create a new sandbox
            requestId: req_mh3k2f9aQ1xYz0aBcDeFgHiJ
    Member:
      type: object
      properties:
        userId:
          type: string
        email:
          type: string
        name:
          type: string
        role:
          $ref: '#/components/schemas/Role'
        addedAt:
          $ref: '#/components/schemas/Millis'
      required:
        - userId
        - email
        - name
        - role
        - addedAt
      additionalProperties: false
    PendingInvite:
      type: object
      properties:
        email:
          type: string
        invitedAt:
          $ref: '#/components/schemas/Millis'
        invitedBy:
          type:
            - string
            - 'null'
          description: The inviter's email, or null if they no longer have an account.
        expiresAt:
          $ref: '#/components/schemas/Millis'
          description: >-
            A week after it was sent or last renewed. An expired invite is not
            honoured; invite the address again to renew it.
        status:
          type: string
          enum:
            - pending
            - expired
      required:
        - email
        - invitedAt
        - invitedBy
        - expiresAt
        - status
      additionalProperties: false
    Role:
      type: string
      enum:
        - owner
        - member
    Millis:
      type: integer
      minimum: 0
      description: A time, in Unix milliseconds.
  headers:
    RequestId:
      description: This request's id, `req_…`. Quote it when asking for help.
      required: true
      schema:
        type: string
        pattern: ^req_
  responses:
    RateLimited:
      description: >-
        `rate-limit`: this team has sent more than 120 requests in the last 60
        s, or this client address more than 600 (fewer on the routes that need
        no credential). The `Retry-After` header gives the seconds left in the
        window.
      headers:
        x-request-id:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          schema:
            type: string
          description: Seconds until the window opens again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A team API key, `sk_offstage_…`, created in the console. Everything it
        touches belongs to its team.
    consoleSession:
      type: apiKey
      in: cookie
      name: oc_session
      description: >-
        The console's session cookie (httpOnly, SameSite=Lax, 30 days), set by
        `signup` and `login`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.