Project handshake
Handshake request from LViS to service on new project creation or existing project update.
postProject handshake
post
https://example-service.lvis.io/lvis/:lvis_instance_id/projects
Request
Response
Request
Path Parameters
lvis_instance_id
required
string
Unique identifier across all LViS instances, in UUID format.
Body Parameters
project_id
required
string
Project UUID.
project_name
required
string
Human-readable project name.
config
required
object
Configuration object as specified in application spec.
api_key
required
string
Bearer token that is required to send Control API requests.
Response
200: OK
Response on the project handshake request. Empty JSON object as response body is required.
{}
This endpoint is called when project and service association has changed, which could happen when:
New project is created
New service is added to existing project
Service configuration in the app spec is updated
Service is manually reloaded for the project in Studio
It's up to the service to decide if it needs to create a new project within the service database or update existing project based on provided project UUID. In case of an update project_name, config and api_key may have changed values.
If api_key has been changed, the previous key has been revoked and not valid anymore.
curl --request POST \--url https://example-service.lvis.io/lvis/c068dd33-46c3-4789-a619-b14e4bcbe990/projects \--header 'Content-Type: application/vnd.api+json' \--data '{"project_id": "da34516f-00af-435e-bd03-ab1720755dda","project_name": "Project X","config": {},"api_key": "td18FzQxQ8ZgCAc9oHpQis8WJqkEn5B9"}'