GuidesAPIMCP

Decline Envelope API

---

title: Decline Envelope API

description: Atlas REST for Decline Envelope API: create, review, send, remind, void, and extract contract data after the last signature.

date: 2026-06-20

updated: 2026-06-20

---

Developers searching "decline envelope api" usually want a concrete REST path, not a marketing overview. This guide documents Atlas patterns you can verify in one afternoon.

Share: One POST to create, one review click, one webhook when signed.

Decline route

Signers decline via:

curl -X POST https://atlaswork.ai/api/envelope/{id}/decline \
 -H "Authorization: Bearer $SIGNER_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"reason": "Terms not acceptable"}'

Envelope sets declined_at; status trigger derives declined. Webhook: envelope.declined.

Sender-side void for pending work without signer action:

curl -X POST https://atlaswork.ai/api/envelope/{id}/void \
 -H "Authorization: Bearer $ATLAS_API_KEY"

Void pending with zero signed parties refunds one credit.

curl -X POST https://atlaswork.ai/api/envelope \
 -H "Authorization: Bearer $ATLAS_API_KEY" \
 -H "Content-Type: application/json" \
 -H "Idempotency-Key: decline-envelope-api-create-1" \
 -d '{
 "document_url": "https://example.com/nda.pdf",
 "parties": [{"email": "signer@example.com", "name": "Jane Signer", "role": "Customer"}],
 "webhook_url": "https://your-app.com/atlas/webhook"
 }'

Webhook on decline

Subscribe to envelope.declined on your webhook_url. Verify X-Atlas-Signature HMAC.

FAQ

Does Atlas support PDF and DOCX? Yes on every create path. DOCX converts to PDF at ingest.

How do I authenticate? Bearer API key from dashboard settings. OAuth for hosted MCP connectors.

What does send cost? One credit per envelope dispatched. Five free credits on signup.

Where do I start? /docs/guides/e-signature-api and API reference.

Related reading

Production notes

Log envelope_id on every create for decline envelope api. Alert on 402 and 409 responses in ops channels.

Security

Store API keys server-side. Verify webhook HMAC before updating database rows. Rotate keys from dashboard if leaked.

Observability

Track time from create to signed PDF. Use webhooks as source of truth instead of aggressive polling.

Formats

Upload PDF or DOCX on every path. Signers always view the stored PDF.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.

Checklist for decline envelope api

  1. Create with Idempotency-Key.
  2. Wait for fields_status ready.
  3. Human review on first template version.
  4. Wire webhooks before production.
  5. Store signed PDF in your object store.