Create capital outcomes engagement handoffs

POST

https://api.sureshake.com/v2/startups/{startupListingId}/engagement-requests/{engagementRequestId}/capital-outcomes-handoff

Path parameters

startupListingId
string
required
format: uuid

engagementRequestId
string
required
format: uuid

Request body JSON required

idempotencyKey
string
required
format: uuid

Returns

201

Default Response

JSON

data
object
required
- id
  string
  required
  format: uuid
- startupListingId
  string
  required
  format: uuid
- startupEntityId
  string
  required
  format: uuid
- relationshipId
  string
  required
  format: uuid
- classification
  object
  required
  stage
  meeting
  or
  diligence
  required
  eventType
  investor.meeting_requested
  or
  investor.report_requested
  or
  investor.diligence_requested
  required
  category
  qualified_engagement
  required
  qualifiedAction
  true
  required
  countsAsCapitalAccessOutcome
  false
  required
  evidenceKind
  explicit_engagement_record
  required
  definitionVersion
  marketplace-capital-engagement/v1
  required
- source
  object
  required
  recordType
  startup_engagement_request
  required
  recordId
  string
  required
  format: uuid
  activityEventId
  string
  required
  format: uuid
  occurredAt
  string
  required
  format: date-time
  actorUserId
  string
  required
  minLength: 1
  principal
  object
  required
  type
  entity
  required
  id
  string
  required
  format: uuid
- handoff
  object
  required
  status
  accepted
  required
  handedOffByUserId
  string
  required
  minLength: 1
  handedOffAt
  string
  required
  format: date-time
}
meta
optional
object
- timestamp
  string
  required
  format: date-time
}

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

409

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

Create capital outcomes engagement handoffs

curl --request POST \
  --url 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1"
}
'

const url = 'https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({idempotencyKey: '0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.sureshake.com/v2/startups/<startupListingId>/engagement-requests/<engagementRequestId>/capital-outcomes-handoff"

payload = { "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1" }
headers = {"Content-Type": "application/json"}

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

print(response.text)

Response example

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "startupListingId": "d16a646b-f433-44ce-aaae-42761cf79f25",
    "startupEntityId": "e54dea79-aa5c-4e2a-93df-a0dcd373cd04",
    "relationshipId": "928dd5b8-3ead-4528-bdef-9c0b867a5d7d",
    "classification": {
      "stage": "meeting",
      "eventType": "investor.meeting_requested",
      "category": "qualified_engagement",
      "qualifiedAction": true,
      "countsAsCapitalAccessOutcome": false,
      "evidenceKind": "explicit_engagement_record",
      "definitionVersion": "marketplace-capital-engagement/v1"
    },
    "source": {
      "recordType": "startup_engagement_request",
      "recordId": "0470cfd4-dcf3-4d8c-ac28-58c6deeff25f",
      "activityEventId": "265b14df-2489-447a-bd2e-4ca441f47b54",
      "occurredAt": "2019-08-24T14:15:22Z",
      "actorUserId": "string",
      "principal": {
        "type": "entity",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    },
    "handoff": {
      "status": "accepted",
      "handedOffByUserId": "string",
      "handedOffAt": "2019-08-24T14:15:22Z"
    }
  },
  "meta": {
    "timestamp": "2019-08-24T14:15:22Z"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "traceId": "string"
  }
}