Precision Planting Panorama Credentials

Form of a Panorama Credentials resource:

{
"clientId": "str",
"username": "str",
"password": "str",
"organizationCode": "str",
"refreshToken": "str",
"clientEnvironment": "str"
}
tip

The recommended way to create Panorama credentials is through the one-click integration endpoint: POST /users/{leafUserId}/one-click-integration/Panorama. This handles the Cognito token exchange and sharing handshake automatically. See the Panorama authentication tutorial for a full walkthrough.

All HTTP methods should be prepended by this service's endpoint:

https://api.withleaf.io/services/usermanagement/api

See below the REST resources and their endpoints available in this service.

Endpoints

DescriptionEndpoints
Get the Panorama credentialsGET /users/{leafUserId}/panorama-credentials
Create Panorama credentialsPOST /users/{leafUserId}/panorama-credentials
Delete Panorama credentialsDELETE /users/{leafUserId}/panorama-credentials

Panorama Credentials Endpoints

Get the Panorama credentials

 GET /users/{leafUserId}/panorama-credentials

Get the Panorama credentials of the Leaf User based on its id and returns a JSON with the credentials. If during background processing we detect that this credential is no longer valid, the value of the status will be changed.

Request examples

curl -X GET \
-H 'Authorization: Bearer YOUR_TOKEN' \
'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/panorama-credentials'

Response

{
"id": "str",
"status": "str",
"createdTime": "yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'",
"clientId": "str",
"username": "str",
"organizationCode": "str",
"clientEnvironment": "STAGE",
"accessToken": "str",
"refreshToken": "str"
}

Create Panorama credentials

 POST /users/{leafUserId}/panorama-credentials

Create Panorama credentials for the Leaf User.

Request body

{
"clientId": "str",
"username": "str",
"password": "str",
"organizationCode": "str",
"refreshToken": "str",
"clientEnvironment": "STAGE" or "PRODUCTION"
}

Request examples

curl -X POST \
-H 'Authorization: Bearer YOUR_TOKEN' \
-d '{"clientId": "str", "username": "str", "password": "str", "organizationCode": "str", "refreshToken": "str", "clientEnvironment": "STAGE"}' \
'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/panorama-credentials'

Response

A Panorama credentials with status.

{
"id": "str",
"status": "str",
"createdTime": "yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'",
"clientId": "str",
"username": "str",
"organizationCode": "str",
"clientEnvironment": "STAGE",
"accessToken": "str",
"refreshToken": "str"
}

Delete Panorama credentials

 DELETE /users/{leafUserId}/panorama-credentials

Delete Leaf User's Panorama credentials.

Request examples

curl -X DELETE \
-H 'Authorization: Bearer YOUR_TOKEN' \
'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/panorama-credentials'

Troubleshooting

With these endpoints, you can do some troubleshooting to see your credential's health.

Events

 GET /users/{leafUserId}/panorama-credentials/events

Get the logs of the provider credential based on the LeafUserId sent.

Request examples

curl -X GET \
-H 'Authorization: Bearer YOUR_TOKEN' \
'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/panorama-credentials/events'

Response

[
{
"body": "string",
"createdDate": "yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'",
"headers": "string",
"id": "string",
"statusCode": "int"
}
]
warning

The logs are available only for 30 days and once the credential is deleted or disassociated with the Leaf User, the logs are no longer available.

Edit this page