Mark P4 import as running

Mark the Perforce import job as currently running by generating a new running_job_id and setting the start timestamp. This should be called when a continuous import job begins.

POST /repos/{repo_id}/p4-import-state/mark-running

Mark P4 import as running

cURL

curl --request POST \
  --url https://api.diversion.dev/v0/repos/{repo_id}/p4-import-state/mark-running \
  --header 'Authorization: Bearer <token>'

200

{
  "running_job_id": "<string>"
}

Authorizations

Authorization · string · header · required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

repo_id · string · required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128

Example:

"example_id"

Query Parameters

branch_ref · string

Ref ID of the branch to import to

Required string length: 1 - 128

Example:

"dv.branch.1"

p4_import_path · string

Path in Perforce depot to import from

Required string length: 1 - 1024

Example:

"//depot/main/..."

Response

200

application/json

Job marked as running successfully

running_job_id · string · required

The generated UUID for this running job instance