Help CenterOpenAPI SpecStatus
DocumentationAPI ReferenceChangelogIntegration Guides
DocumentationAPI ReferenceChangelogIntegration Guides
  • Getting Started
    • Introduction
    • Quickstart Tutorial
  • API Overview
    • API Keys
    • Authentication
    • Protocol
    • Idempotence
    • Pagination
    • Serialization
    • Rate Limiting
    • Downloading Files
    • API Logs
    • Request IDs
  • Versioning
    • API Changelog
    • Versioning
  • Troubleshooting
    • Error Handling
  • API Reference
    • OpenAPI Specification
    • Cases
    • Documents
    • Inquiries
    • List Items
    • Lists
    • OAuth
    • Reports
    • Transactions
    • Verifications
    • Workflows
  • Webhooks
LogoLogo
Help CenterOpenAPI SpecStatus
API ReferenceConnect

Update a Connect Connection

PATCH
https://api.withpersona.com/api/v1/connect/connections/:connection-id
PATCH
/api/v1/connect/connections/:connection-id
1curl -X PATCH https://api.withpersona.com/api/v1/connect/connections/cxn_ABC123 \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json"
Try it
1{
2 "data": {
3 "type": "connect/connection",
4 "id": "cxn_ABC123",
5 "attributes": {
6 "token": "cxn_ABC123",
7 "name": "Partner Connection",
8 "status": "active",
9 "organization-id": "org_ABC123",
10 "destination-organization-id": "org_DEF456",
11 "scopes": [
12 "inquiry.read",
13 "account.read"
14 ],
15 "creator-id": "api_ABC123",
16 "creator-type": "api-key",
17 "created-at": "2018-06-01T00:00:00.000Z",
18 "updated-at": "2018-06-01T00:00:00.000Z"
19 }
20 }
21}
Updates an existing Connect Connection.
Was this page helpful?
Previous

Deactivate a Connect Connection

Next
Built with
Deactivate a Connect Connection
Updates an existing Connect Connection.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

connection-idstringRequired
Token of the connect connection

Headers

Key-InflectionenumOptional
Determines casing for the API response.
Allowed values:
Idempotency-KeystringOptional
Ensures the request is idempotent.
Persona-VersionenumOptionalDefaults to 2023-01-05
Allowed values:

Query parameters

fieldsmap from strings to stringsOptional
Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.

Request

This endpoint expects an object.
dataobjectOptional

Response

This endpoint returns a Connect Connection.
dataobject
A Connect Connection object. This object represents a connection between organizations for sharing access to Persona objects.

Errors

Ensures the request is idempotent.
This endpoint returns a Connect Connection.

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.