---
title: "Add a separate subscription account [write]"
method: POST
path: "/model-subscriptions"
---

# Add a separate subscription account \[write\]

`POST /model-subscriptions`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/model-subscriptions`
- Auth: HTTP bearer

## Request body

- AddModelSubscription
  - `credential` string, required
  - `label` string
  - `provider` 'anthropic' | 'openai' | 'cursor' | 'xai' | 'meta', required

## Response `201`

Created

- object
  - `modelSubscription` ModelSubscription, required: A connected consumer AI subscription (Claude Pro/Max, ChatGPT, Cursor, Grok or Muse plan) powering eligible agents at $0 model usage. The credential itself is write-only.
    - `provider` 'anthropic' | 'openai' | 'cursor' | 'xai' | 'meta'
    - `accountId` string: Additional account identifier; omitted for the legacy provider account
    - `label` string
    - `status` 'connected' | 'needs_reconnect' | 'org_disabled': connected runs agents; needs_reconnect lost its credential; org_disabled is signed in to an organization that turned off plan access for this harness, so nothing runs on it until it is reconnected
    - `expiresAt` string, nullable
    - `lastUsedAt` string, nullable
    - `useForNewAgents` boolean
    - `createdAt` string
    - `agents` object[]: Agents in this universe running on the subscription
      - `id` string
      - `agentId` string, nullable
      - `name` string

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 3 warning, 6 info
  - added the new `meta` enum value to the `modelSubscription/provider` response property for the response status `201`
  - added the new `org_disabled` enum value to the `modelSubscription/status` response property for the response status `201`
  - added the new `xai` enum value to the `modelSubscription/provider` response property for the response status `201`
  - added the new `meta` enum value to the request property `provider`
  - …5 more

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/model-subscriptions/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)