---
title: "Open Card Intent"
method: POST
path: "/agent/spaces/{space_id}/card/intents"
tags: ["agent"]
---

# Open Card Intent

`POST /agent/spaces/{space_id}/card/intents`

## Request

- Base URL: `https://app.orla.finance/api`
- URL: `https://app.orla.finance/api/agent/spaces/{space_id}/card/intents`
- Auth: HTTP bearer

Declare a purchase before the card pays for it.

## Path parameters

- `space_id` string, uuid, required

## Request body

- CardIntentOpenIn: What an agent declares before its card pays.
  - `category_id` string, uuid, nullable
  - `ceiling_usd` union, required
    - number
    - string
  - `expires_in_hours` integer, nullable
  - `kind` 'one_off' | 'recurring'
  - `merchant` string, required
  - `months` integer, nullable
  - `period` 'month' | 'year', nullable
  - `purpose` string, required

## Response `200`

Successful Response

- AgentWriteOut: The answer to every mutating agent call.
  - `applied` boolean, required
  - `message` string
  - `proposal_id` string, uuid, nullable
  - `result` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors.md) · [All operations](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/llms.txt) · [OpenAPI document](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/revisions/62d5d0a3ba7a?raw)