Activate a signed quote

POST

quotes

{id}

activate

curl --request POST \
  --url https://api.alguna.io/quotes/{id}/activate \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.alguna.io/quotes/{id}/activate"

headers = {
    "Alguna-Version": "<alguna-version>",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Alguna-Version': '<alguna-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.alguna.io/quotes/{id}/activate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "auto_activate": false,
  "contract": {
    "period_type": "fixed",
    "duration_months": 12,
    "end_date": "2027-01-01T00:00:00Z",
    "start_date": "2026-01-01T00:00:00Z"
  },
  "created_at": "2026-08-21T10:00:00Z",
  "currency": "USD",
  "customer_id": "cust_abc123",
  "id": "qt_abc123",
  "kind": "new",
  "name": "Acme Platform 2026",
  "status": "draft",
  "subscription_id": "sub_abc123",
  "updated_at": "2026-08-21T10:00:00Z",
  "expires_at": "2026-09-30T23:59:59Z",
  "signing_url": "https://acme.alguna.io/hs/elt_abc123",
  "withdrawal_reason": "Superseded by revised terms",
  "withdrawn_at": "2026-09-15T09:00:00Z"
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version

enum<string>

required

Available options:

2026-04-01

Idempotency-Key

string

A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.

Maximum string length: 255

Example:

"ik_a1b2c3d4e5f6"

Path Parameters

string

required

Unique identifier for the quote

Response

Success

auto_activate

boolean

required

Whether this quote takes effect on its own once signed; otherwise activate it with Activate a Signed Quote

Example:

false

contract

object

required

Term of the subscription this quote documents

Show child attributes

created_at

string<date-time>

required

When the quote was created

Example:

"2026-08-21T10:00:00Z"

currency

string

required

ISO 4217 currency code

Example:

"USD"

customer_id

string

required

Customer ID

Example:

"cust_abc123"

string

required

Quote ID

Example:

"qt_abc123"

kind

enum<string>

required

Quote kind

Available options:

new,

renewal,

amendment

Example:

"new"

name

string

required

Display name of the quote: its own override when one is set, otherwise the name of the subscription it documents

Example:

"Acme Platform 2026"

status

enum<string>

required

Document status

Available options:

draft,

pending_approval,

sent,

signed,

rejected,

withdrawn,

expired

Example:

"draft"

subscription_id

string

required

The subscription this quote creates or amends. Whether the deal is in effect is that subscription's state, not the quote's: read it, or its phases, once the quote is signed.

Example:

"sub_abc123"

updated_at

string<date-time>

required

When the quote was last updated

Example:

"2026-08-21T10:00:00Z"

expires_at

string<date-time> | null

When the signing offer expires; null means it never expires

Example:

"2026-09-30T23:59:59Z"

signing_url

string | null

Hosted page where the customer reviews and signs. Present on a single quote while a customer signature is pending, so a lost link can be recovered; omitted on the list.

Example:

"https://acme.alguna.io/hs/elt_abc123"

withdrawal_reason

string | null

Reason recorded on withdrawal

Example:

"Superseded by revised terms"

withdrawn_at

string<date-time> | null

When the quote was withdrawn, if withdrawn

Example:

"2026-09-15T09:00:00Z"

⌘I

Activate a signed quote

curl --request POST \
  --url https://api.alguna.io/quotes/{id}/activate \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.alguna.io/quotes/{id}/activate"

headers = {
    "Alguna-Version": "<alguna-version>",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Alguna-Version': '<alguna-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.alguna.io/quotes/{id}/activate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "auto_activate": false,
  "contract": {
    "period_type": "fixed",
    "duration_months": 12,
    "end_date": "2027-01-01T00:00:00Z",
    "start_date": "2026-01-01T00:00:00Z"
  },
  "created_at": "2026-08-21T10:00:00Z",
  "currency": "USD",
  "customer_id": "cust_abc123",
  "id": "qt_abc123",
  "kind": "new",
  "name": "Acme Platform 2026",
  "status": "draft",
  "subscription_id": "sub_abc123",
  "updated_at": "2026-08-21T10:00:00Z",
  "expires_at": "2026-09-30T23:59:59Z",
  "signing_url": "https://acme.alguna.io/hs/elt_abc123",
  "withdrawal_reason": "Superseded by revised terms",
  "withdrawn_at": "2026-09-15T09:00:00Z"
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

API Reference

Examples

SDKs

API Reference

Webhooks

Activate a signed quote

Authorizations

Headers

Path Parameters

Response