Import Cross-Site Authorization Meta¶

POST /api/v1/workspace_data/cross_site_grant/meta/import

Overview¶

Body Parameters¶

Parameter	Type	Required	Description
meta	json		The complete cross-site authorization meta JSON generated by the authorizing party. Allow empty: False

Parameter Details¶

The authorized party imports the cross-site authorization meta generated by the authorizing party. After import, the authorized party actively accesses the authorizing party's site to complete authentication and synchronization; the authorizing party does not actively access the authorized party.

For details, refer to: Deployment Plan Cross-Site Authorization Usage Guide

The Deployment Plan service must be upgraded to at least the version released on 2026-06-03 to support the new version of inter-site authorization.
After successful import, a mirror authorization record will be generated locally; this record must become active before it can be used by the workspace selector, authorization verification, and DQL queries.
Repeatedly importing the same valid meta will return an existing authorization or duplicate authorization error, subject to the interface response.
Subsequent business modifications and revocations still use /wksp_share/<uuid>/modify and /wksp_share/delete.

Request Example¶

curl 'https://openapi.guance.com/api/v1/workspace_data/cross_site_grant/meta/import' \
-H 'Content-Type: application/json' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"meta":{"version":"2026-05-27","metaUUID":"meta_1","sourceWorkspace":{"workspaceUUID":"wksp_source","workspaceName":"Authorizing Workspace"},"targetWorkspaceUUID":"wksp_target","sourceSite":{"regionCode":"testing","publicKeys":[{"kid":"kid_1","publicKey":"-----BEGIN PUBLIC KEY-----..."}]},"grantScope":{"type":["logging"],"indexes":["*"],"conditions":{}},"auth":{"tempAuthCode":"temp_code_xxx","tempAuthCodeExpireAt":1770000000},"security":{"signAlg":"RS256","kid":"kid_1"},"signature":"<JWS>"}}' \
--compressed

Response¶

{
    "code": 200,
    "content": {
        "grantUUID": "grant_mirror_1",
        "status": "active",
        "recordRole": "mirror",
        "duplicated": false,
        "sourceWorkspaceUUID": "wksp_source",
        "targetWorkspaceUUID": "wksp_target",
        "sourceWorkspaceName": "Authorizing Workspace",
        "targetWorkspaceName": "Authorized Workspace",
        "regionCode": "testing",
        "toRegionCode": "us1",
        "siteRelationType": "same_org_cross_site"
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-EXAMPLE"
}