Accept opportunity suggestion

Creates a prefilled opportunity and atomically marks the suggestion accepted.

RBAC · opportunities

Path parameters

idstring <uuid>Required

Suggestion UUID from opportunity_suggestions.suggestion_id.

Request body

Content type: application/json · schema AcceptOpportunitySuggestionBodyV1

titlestring

min length 1

contact_idstring <uuid>Nullable

owner_idstring <uuid>

mrr_centsinteger

≥ 0

nrr_centsinteger

≥ 0

hardware_centsinteger

≥ 0

currency_codestring

min length 3 · max length 3

expected_close_datestringNullable

pattern /^\d{4}-\d{2}-\d{2}$/

next_actionstring

min length 1

next_action_duestring <date-time>

Response body

Success response 201 · schema OpportunityApiSuccessV1

dataobjectRequired

metaobject

Response codes

201

Operation succeeded.

400

Validation or request parsing failure.

401

API key missing or invalid.

403

RBAC denied for the opportunities resource action.

404

Opportunity or nested resource not found.

409

Opportunity state conflicts with the requested operation.

500

Unexpected controller or service failure.

POST /api/v1/opportunities/suggestions/{id}/accept

cURL

curl -X POST "https://algapsa.com/api/v1/opportunities/suggestions/{id}/accept" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "x",
  "contact_id": "01HN2K7VRB9PQ3Y0000000000",
  "owner_id": "01HN2K7VRB9PQ3Y0000000000",
  "mrr_cents": 0,
  "nrr_cents": 0,
  "hardware_cents": 0,
  "currency_code": "xxx",
  "expected_close_date": "",
  "next_action": "x",
  "next_action_due": "2026-04-18T15:22:14Z"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/opportunities/suggestions/{id}/accept", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "x",
    "contact_id": "01HN2K7VRB9PQ3Y0000000000",
    "owner_id": "01HN2K7VRB9PQ3Y0000000000",
    "mrr_cents": 0,
    "nrr_cents": 0,
    "hardware_cents": 0,
    "currency_code": "xxx",
    "expected_close_date": "",
    "next_action": "x",
    "next_action_due": "2026-04-18T15:22:14Z"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/opportunities/suggestions/{id}/accept");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""title"": ""x"",
  ""contact_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""owner_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""mrr_cents"": 0,
  ""nrr_cents"": 0,
  ""hardware_cents"": 0,
  ""currency_code"": ""xxx"",
  ""expected_close_date"": """",
  ""next_action"": ""x"",
  ""next_action_due"": ""2026-04-18T15:22:14Z""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

201 OK·application/json

{
  "data": {},
  "meta": {}
}