Skip to main content

public_apis.core_fast.main (0.1.0)

Download OpenAPI specification:Download

health_check

Health Check

Ping health check endpoint. If the service responds with a HTTP status 200, the application should be running as expected.

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

banners

Get All Banners

query Parameters
limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Post

Request Body schema: application/json
required
banner_message
required
string (Banner Message)
start_datetime
required
string <date-time> (Start Datetime)
end_datetime
required
string <date-time> (End Datetime)
level
string (BannerLevel)
Default: "INFO"
Enum: "INFO" "WARNING"

An enumeration.

Responses

Request samples

Content type
application/json
{
  • "banner_message": "string",
  • "start_datetime": "2019-08-24T14:15:22Z",
  • "end_datetime": "2019-08-24T14:15:22Z",
  • "level": "INFO"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Update

path Parameters
banner_id
required
string <uuid> (Banner Id)
Request Body schema: application/json
required
banner_message
string (Banner Message)
start_datetime
string <date-time> (Start Datetime)
end_datetime
string <date-time> (End Datetime)
level
string (BannerLevel)
Enum: "INFO" "WARNING"

An enumeration.

Responses

Request samples

Content type
application/json
{
  • "banner_message": "string",
  • "start_datetime": "2019-08-24T14:15:22Z",
  • "end_datetime": "2019-08-24T14:15:22Z",
  • "level": "INFO"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Delete

path Parameters
banner_id
required
string <uuid> (Banner Id)

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ]
}

batches

Get Last Activity Date

Retrieve last_activity_date by projects.

Args: AuthenticatedComputeSuperuser: The authentication dependency, ensuring the user is authenticated and has the necessary permissions.

project_id:  Project ID as parameter query. Supports multiple IDs with
&. (/batches/last_activity?project_id=id1&project_id=id2)

Returns: A non-paginated response containing latest activity date by projects.

query Parameters
project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get Statistics

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get All Batches

query Parameters
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the batch

id__starts_with
string (Id Starts With)
Default: ""

First characters of the batch id

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the batch

user_id
Array of strings (User Id)
Default: ""

Owner user of the batch

device_type
Array of strings (Device Type)
Default: ""

Device type enum

status
Array of strings (BatchStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "CANCELED" "TIMED_OUT" "ERROR" "PAUSED"

Batch status type enum

complete
boolean (Complete)
Default: ""

Flag indicating whether the batch is waiting for extra jobs to be pushed

open
boolean (Open)
Default: ""

Flag indicating whether the batch is waiting for extra jobs to be pushed

min_jobs
integer (Min Jobs)
Default: ""

Minimum number of jobs in the batch

max_jobs
integer (Max Jobs)
Default: ""

Maximum number of jobs in the batch

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a batch was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a batch finished, failed or was cancelled

queue_priority
Array of strings (QueuePriority)
Default: ""
Items Enum: "LOW" "MEDIUM" "HIGH"

Priority of the batch in the queue.

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Create Batch

Request Body schema: application/json
required
configuration
any (Configuration)
priority
number (Priority)
project_id
required
string <uuid> (Project Id)
emulator
string (DeviceTypeName)
Enum: "EMU_FREE" "EMU_SV" "EMU_TN" "EMU_C" "FRESNEL" "EMU_FRESNEL"

Enumeration of allowed and legacy device type names

sequence_builder
required
string (Sequence Builder)
tags
Array of strings (Tags) unique
complete
boolean (Complete)
open
boolean (Open)
Array of objects (Jobs)
Default: []

Responses

Request samples

Content type
application/json
{
  • "configuration": null,
  • "priority": 0,
  • "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  • "emulator": "EMU_FREE",
  • "sequence_builder": "string",
  • "tags": [
    ],
  • "complete": true,
  • "open": true,
  • "jobs": [ ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Batch

path Parameters
batch_id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Set Batch Status

path Parameters
batch_id
required
string <uuid> (Batch Id)
Request Body schema: application/json
required
status
string (BatchStatus)
Enum: "PENDING" "RUNNING" "DONE" "CANCELED" "TIMED_OUT" "ERROR" "PAUSED"

An enumeration.

device_id
string <uuid> (Device Id)
start_datetime
string <date-time> (Start Datetime)
end_datetime
string <date-time> (End Datetime)

Responses

Request samples

Content type
application/json
{
  • "status": "PENDING",
  • "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
  • "start_datetime": "2019-08-24T14:15:22Z",
  • "end_datetime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Set Batch Tags

path Parameters
batch_id
required
string <uuid> (Batch Id)
Request Body schema: application/json
required
add
Array of strings (Add) unique
remove
Array of strings (Remove) unique

Responses

Request samples

Content type
application/json
{
  • "add": [
    ],
  • "remove": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Close Batch

path Parameters
batch__id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Batches

Cancel a group of batches.

Request Body schema: application/json
required
batch_ids
required
Array of strings <uuid> (Batch Ids) [ items <uuid > ]

Responses

Request samples

Content type
application/json
{
  • "batch_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Batch

Cancel a batch.

path Parameters
batch__id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Results

path Parameters
batch__id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
null

Add Jobs

path Parameters
batch__id
required
string <uuid> (Batch Id)
Request Body schema: application/json
required
Array
runs
required
integer (Runs)
variables
object (Variables)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "data": {
    }
}

Rebatch Jobs

path Parameters
batch__id
required
string <uuid> (Batch Id)
query Parameters
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the job

id__starts_with
string (Id Starts With)
Default: ""

First characters of the job id

batch_id
Array of strings <uuid> (Batch Id) [ items <uuid > ]
Default: ""

Owner batch of the job

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the job

user_id
Array of strings (User Id)
Default: ""

Owner user of the job

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

min_runs
integer (Min Runs)
Default: ""

Minimum number of times the pulser sequence is repeated

max_runs
integer (Max Runs)
Default: ""

Maximum number of times the pulser sequence is repeated

errors
boolean (Errors)
Default: ""

Whether errors werer returned when executing the job

origin
Array of strings (JobOrigin)
Default: ""
Items Enum: "CLIENT" "AZURE" "UNKNOWN"

Origin of the job

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a job was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a job finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Jobs

path Parameters
batch__id
required
string <uuid> (Batch Id)
query Parameters
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the job

id__starts_with
string (Id Starts With)
Default: ""

First characters of the job id

batch_id
Array of strings <uuid> (Batch Id) [ items <uuid > ]
Default: ""

Owner batch of the job

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the job

user_id
Array of strings (User Id)
Default: ""

Owner user of the job

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

min_runs
integer (Min Runs)
Default: ""

Minimum number of times the pulser sequence is repeated

max_runs
integer (Max Runs)
Default: ""

Maximum number of times the pulser sequence is repeated

errors
boolean (Errors)
Default: ""

Whether errors werer returned when executing the job

origin
Array of strings (JobOrigin)
Default: ""
Items Enum: "CLIENT" "AZURE" "UNKNOWN"

Origin of the job

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a job was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a job finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Batch

Get batch by batch_id.

Args: AuthenticatedComputeAny: The authentication dependency, ensuring the user is authenticated and has the necessary permissions user (GetUserInfoWithProjects): A dependency that will fetch the user information. batch_id(UUID): requested batch id

Returns: The requested Batch.

Raises: BatchNotFound(Http status code 404) if batch_id not found or the user is not member of the batch's project.

path Parameters
batch_id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Jobs

path Parameters
batch__id
required
string <uuid> (Batch Id)
query Parameters
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the job

id__starts_with
string (Id Starts With)
Default: ""

First characters of the job id

batch_id
Array of strings <uuid> (Batch Id) [ items <uuid > ]
Default: ""

Owner batch of the job

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the job

user_id
Array of strings (User Id)
Default: ""

Owner user of the job

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

min_runs
integer (Min Runs)
Default: ""

Minimum number of times the pulser sequence is repeated

max_runs
integer (Max Runs)
Default: ""

Maximum number of times the pulser sequence is repeated

errors
boolean (Errors)
Default: ""

Whether errors werer returned when executing the job

origin
Array of strings (JobOrigin)
Default: ""
Items Enum: "CLIENT" "AZURE" "UNKNOWN"

Origin of the job

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a job was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a job finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Batch

Cancel a batch.

path Parameters
batch__id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Complete Batch

path Parameters
batch__id
required
string <uuid> (Batch Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Add Jobs

path Parameters
batch__id
required
string <uuid> (Batch Id)
Request Body schema: application/json
required
Array
runs
required
integer (Runs)
variables
object (Variables)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "data": {
    }
}

devices

Get All Devices

query Parameters
include_legacy
boolean (Include Legacy)
Default: false
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Create Device

Request Body schema: application/json
required
status
required
string (DeviceStatus)
Enum: "UP" "DOWN"

An enumeration.

device_type
required
string (DeviceTypeName)
Enum: "EMU_FREE" "EMU_SV" "EMU_TN" "EMU_C" "FRESNEL" "EMU_FRESNEL"

Enumeration of allowed and legacy device type names

specs
required
string (Specs)
is_emulator
required
boolean (Is Emulator)
has_execution_logs
required
boolean (Has Execution Logs)
active
boolean (Active)
Default: true
allowed_result_types
required
Array of strings (ResultsType)
Items Enum: "counter" "run" "sample" "expectation"
default_result_types
required
Array of strings (ResultsType)
Items Enum: "counter" "run" "sample" "expectation"

Responses

Request samples

Content type
application/json
{
  • "status": "UP",
  • "device_type": "EMU_FREE",
  • "specs": "string",
  • "is_emulator": true,
  • "has_execution_logs": true,
  • "active": true,
  • "allowed_result_types": [
    ],
  • "default_result_types": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Set Status

path Parameters
device_id
required
string <uuid> (Device Id)
Request Body schema: application/json
required
status
required
string (DeviceStatus)
Enum: "UP" "DOWN"

An enumeration.

Responses

Request samples

Content type
application/json
{
  • "status": "UP"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Active Devices

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get Queue Size

path Parameters
device
required
string (DeviceTypeName)
Enum: "EMU_FREE" "EMU_SV" "EMU_TN" "EMU_C" "FRESNEL" "EMU_FRESNEL"

Enumeration of allowed and legacy device type names

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

specs

Get Device Specs By Device Type

path Parameters
device_type
required
string (DeviceTypeName)
Enum: "EMU_FREE" "EMU_SV" "EMU_TN" "EMU_C" "FRESNEL" "EMU_FRESNEL"

Enumeration of allowed and legacy device type names

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Update Device Specs

path Parameters
device_type
required
string (DeviceTypeName)
Enum: "EMU_FREE" "EMU_SV" "EMU_TN" "EMU_C" "FRESNEL" "EMU_FRESNEL"

Enumeration of allowed and legacy device type names

Request Body schema: application/json
required
specs
required
string (Specs)

Responses

Request samples

Content type
application/json
{
  • "specs": "string"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Device Specs

Responses

Response samples

Content type
application/json
{
  • "property1": "string",
  • "property2": "string"
}

Get Public Device Specs

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

public

Get Public Device Specs

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

jobs

Get Total Job Device Frequency Statistics

Return a data structure detailing how many jobs have been scheduled within a certain scope of time for a specific device.

Scope of time is limited to HOUR, DAY or MONTH and it returns based on total jobs inside a project.

query Parameters
project_id
required
string <uuid> (Project Id)
scope
required
string (Scope)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Post Job Errors

path Parameters
job_id
required
string <uuid> (Job Id)
Request Body schema: application/json
required
errors
required
Array of strings (Errors)

Responses

Request samples

Content type
application/json
{
  • "errors": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Set Job Status

path Parameters
job_id
required
string <uuid> (Job Id)
Request Body schema: application/json
required
status
required
string (JobStatus)
Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

An enumeration.

start_timestamp
string <date-time> (Start Timestamp)
end_timestamp
string <date-time> (End Timestamp)

Responses

Request samples

Content type
application/json
{
  • "status": "PENDING",
  • "start_timestamp": "2019-08-24T14:15:22Z",
  • "end_timestamp": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Job

path Parameters
job_id
required
string <uuid> (Job Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Patch Job

path Parameters
job_id
required
string <uuid> (Job Id)
Request Body schema: application/json
required
status
required
string (JobStatus)
Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

An enumeration.

start_timestamp
string <date-time> (Start Timestamp)
end_timestamp
string <date-time> (End Timestamp)
progress
integer (Progress) [ 0 .. 100 ]

Responses

Request samples

Content type
application/json
{
  • "status": "PENDING",
  • "start_timestamp": "2019-08-24T14:15:22Z",
  • "end_timestamp": "2019-08-24T14:15:22Z",
  • "progress": 100
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Job

path Parameters
job_id
required
string <uuid> (Job Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get All Jobs

query Parameters
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the job

id__starts_with
string (Id Starts With)
Default: ""

First characters of the job id

batch_id
Array of strings <uuid> (Batch Id) [ items <uuid > ]
Default: ""

Owner batch of the job

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the job

user_id
Array of strings (User Id)
Default: ""

Owner user of the job

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

min_runs
integer (Min Runs)
Default: ""

Minimum number of times the pulser sequence is repeated

max_runs
integer (Max Runs)
Default: ""

Maximum number of times the pulser sequence is repeated

errors
boolean (Errors)
Default: ""

Whether errors werer returned when executing the job

origin
Array of strings (JobOrigin)
Default: ""
Items Enum: "CLIENT" "AZURE" "UNKNOWN"

Origin of the job

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a job was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a job finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Get Job

Retrieve a job by its ID.

Args: AuthenticatedComputeAny: The authentication dependency, ensuring the user is authenticated and has the necessary permissions

job: GetJobByIdAndPerformAccessCheck access the job by its ID and perform
access checks. The 'deferred_fields' parameter is specified to exclude the
'result' attribute from being loaded from the database.

Returns: NonPaginatedResponse[ProducedFullJobResponse]: A non-paginated response containing the details of the job, excluding the result attribute

path Parameters
job_id
required
string <uuid> (Job Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Jobs

Retrieve jobs. Args: AuthenticatedComputeUser: The authentication dependency, ensuring the user is authenticated and has the necessary permissions User: Logged user information. Ordering_params: The ordering parameters Paginated_params: The pagination parameters Filter_params: The filter parameters Returns: PaginatedResponse[ProducedPartialJobResponse]: A paginated response containing the list of the requested jobs, excluding the job result attribute

query Parameters
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the job

id__starts_with
string (Id Starts With)
Default: ""

First characters of the job id

batch_id
Array of strings <uuid> (Batch Id) [ items <uuid > ]
Default: ""

Owner batch of the job

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the job

user_id
Array of strings (User Id)
Default: ""

Owner user of the job

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

min_runs
integer (Min Runs)
Default: ""

Minimum number of times the pulser sequence is repeated

max_runs
integer (Max Runs)
Default: ""

Maximum number of times the pulser sequence is repeated

errors
boolean (Errors)
Default: ""

Whether errors werer returned when executing the job

origin
Array of strings (JobOrigin)
Default: ""
Items Enum: "CLIENT" "AZURE" "UNKNOWN"

Origin of the job

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated a job was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated a job finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Cancel Job

path Parameters
job_id
required
string <uuid> (Job Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

learners

Get Or Create

Get the learner for the current user.

Args: package: The package to get the learner for. auth_info: The auth info. Used to constrain the account type.

Returns: QueryResults: The learner.

path Parameters
package
required
string (ProjectPackage)
Enum: "QUANTUM_DISCOVERY" "QUANTUM_DISCOVERY_CHEMISTRY" "QUANTUM_DISCOVERY_LIGHT" "QUANTUM_DISCOVERY_PLAY" "QUANTUM_DISCOVERY_ESSENTIAL" "LEARN_BY_CODING" "VQPU"

An enumeration.

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Update Progress For User And Package

Update the progress for the current user.

Args: package: The package to update the learner for. updated_learner: The schema containing updated progress.

Returns: QueryResults: The learner.

path Parameters
package
required
string (ProjectPackage)
Enum: "QUANTUM_DISCOVERY" "QUANTUM_DISCOVERY_CHEMISTRY" "QUANTUM_DISCOVERY_LIGHT" "QUANTUM_DISCOVERY_PLAY" "QUANTUM_DISCOVERY_ESSENTIAL" "LEARN_BY_CODING" "VQPU"

An enumeration.

Request Body schema: application/json
required
required
object (Progress)
additional property
object (StageType)
stage
required
string (ProgressStage)
Enum: "DONE" "SKIP" "IN_PROGRESS"

Enumeration of progress types

timecode
required
integer (Timecode)

Responses

Request samples

Content type
application/json
{
  • "progress": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Notebook

Get a notebook server for the current user.

Args: package: The package the learner is in. notebook: The specific notebook to spawn

Returns: QueryResults

path Parameters
package
required
string (ProjectPackage)
Enum: "QUANTUM_DISCOVERY" "QUANTUM_DISCOVERY_CHEMISTRY" "QUANTUM_DISCOVERY_LIGHT" "QUANTUM_DISCOVERY_PLAY" "QUANTUM_DISCOVERY_ESSENTIAL" "LEARN_BY_CODING" "VQPU"

An enumeration.

notebook
required
string (Notebook)
query Parameters
project_id
string <uuid> (Project Id)

Responses

Response samples

Content type
application/json

Get For Project

Get the learners for the given project and package.

Args: package: The package to get the learners for. project: The project to get the learners for. ordering_param: The ordering parameters. paginated_params: The pagination parameters.

Returns: QueryResults: The learners.

path Parameters
project_id
required
string <uuid> (Project Id)
query Parameters
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

packages

Get All Packages

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

use_cases

Create Use Case

Create a use-case.

Args: use_case: The use-case to create. user_session: The auth info used to check permissions.

Returns: QueryResults: The created use-case.

Request Body schema: application/json
required
project_id
string <uuid> (Project Id)
title
required
string (Title)
validation_status
required
string (Validation Status)
summary
string (Summary)
questionnaire_id
integer (Questionnaire Id)
answers
object (Answers)

Responses

Request samples

Content type
application/json
{
  • "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  • "title": "string",
  • "validation_status": "string",
  • "summary": "string",
  • "questionnaire_id": 0,
  • "answers": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get Use Case By Id

Get all the data of the requested use-case, including answers.

Args: user_session: The auth info used to check permissions.

Returns: QueryResults: The matching use-case, if found in DB and allowed for user.

path Parameters
use_case_id
required
string <uuid> (Use Case Id)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Partial Use Case Update

Updates a use-case, possibly partially.

Args: use_case_id: ID of the Use case to update. use_case: The use-case fields to update. credential: The auth info used to check permissions. credential_acl: contains the projects accessible by the user

Returns: QueryResults: The resulting updated use case.

path Parameters
use_case_id
required
string <uuid> (Use Case Id)
Request Body schema: application/json
required
title
string (Title)
validation_status
string (Validation Status)
summary
string (Summary)
questionnaire_id
integer (Questionnaire Id)
answers
object (Answers)

Responses

Request samples

Content type
application/json
{
  • "title": "string",
  • "validation_status": "string",
  • "summary": "string",
  • "questionnaire_id": 0,
  • "answers": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get My Use Cases

Get the list of use-cases created by the logged user in the given project.

Args: project_id: the project (=team) for which to retrieve use-cases. credential: The auth info used to check permissions. paginated_params: arguments provided by the client to control pagination. status: If provided, return only use-cases having that status search: If provided, return only use-cases containing that term

Returns: QueryResults: The matching use-cases found in DB.

path Parameters
project_id
required
string <uuid> (Project Id)
query Parameters
status
string (ValidationStatus)
Enum: "DRAFT" "UNDER_REVIEW" "REVIEWER_DRAFT" "REQUIRING_UPDATE" "UPDATED" "REJECTED" "APPROVED"

An enumeration.

search
string (Search)
limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Get Team Use Cases

Get the list of validated use-cases created by other project (team) members of the logged user.

Args: project_id: the project (=team) for which to retrieve use-cases. credential: The auth info used to check permissions. credential_acl: contains the projects accessible by the user paginated_params: arguments provided by the client to control pagination. status: can be used by a super-user to filter by status; regular users only see APPROVED use-cases. search: If provided, return only use-cases containing that term

Returns: QueryResults: The matching use-cases found in DB.

path Parameters
project_id
required
string <uuid> (Project Id)
query Parameters
status
Array of strings (ValidationStatus)
Items Enum: "DRAFT" "UNDER_REVIEW" "REVIEWER_DRAFT" "REQUIRING_UPDATE" "UPDATED" "REJECTED" "APPROVED"
search
string (Search)
limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Get Example Use Cases

Get the list of example use-cases provided by Pasqal.

Returns: QueryResults: The matching use-cases found in DB.

query Parameters
limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Review Use Case

path Parameters
use_case_id
required
string <uuid> (Use Case Id)
Request Body schema: application/json
required
additional property
string or AnswerDict (object)
Any of
string

Responses

Request samples

Content type
application/json
{
  • "property1": "string",
  • "property2": "string"
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

workloads

Create Workload

Request Body schema: application/json
required
project_id
required
string <uuid> (Project Id)
workload_type
required
string (WorkloadType)
Enum: "algorithm_dqgm" "qadence_circuit" "algorithm_pde_basf" "algorithm_pde_equality" "algorithm_qel_posco"

An enumeration.

backend
required
string (BackendName)
Enum: "pyq" "pyqtorch" "digital" "emu_c" "pulser_basic"

An enumeration.

config
required
object (Config)

Responses

Request samples

Content type
application/json
{
  • "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  • "workload_type": "algorithm_dqgm",
  • "backend": "pyq",
  • "config": { }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Post Workload Result

path Parameters
workload_id
required
string <uuid> (Workload Id)
Request Body schema: application/json
required
result
required
object (Result)

Responses

Request samples

Content type
application/json
{
  • "result": { }
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Post Workload Errors

path Parameters
workload_id
required
string <uuid> (Workload Id)
Request Body schema: application/json
required
errors
required
Array of strings (Errors)

Responses

Request samples

Content type
application/json
{
  • "errors": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Set Workload Status

path Parameters
workload_id
required
string <uuid> (Workload Id)
Request Body schema: application/json
required
status
required
string (JobStatus)
Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

An enumeration.

start_timestamp
string <date-time> (Start Timestamp)
end_timestamp
string <date-time> (End Timestamp)

Responses

Request samples

Content type
application/json
{
  • "status": "PENDING",
  • "start_timestamp": "2019-08-24T14:15:22Z",
  • "end_timestamp": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Cancel Workload

Cancel workload by workload_id.

Args: workload (GetWorkloadByIdAndPerformAccessCheck): A dependency that fetches a workload based on the provided workload_id, contingent upon the validation of the specified access_check. Returns: The requested workload.

Raises: WorkloadNotFound(Http status code 404) if workload_id not found or the user is not member of the workload's project. WorkloadWriteAccessRequired(http status code 403) if the the user if not the owner the workload. WorkloadCancelInvalidStatus: The workload cannot be cancelled.

path Parameters
workload_id
required
string <uuid> (Workload Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Workload

Get workload by workload_id.

Returns: The requested workload.

Raises: WorkloadNotFound(Http status code 404) if workload_id not found or the user is not member of the workload's project.

path Parameters
workload_id
required
string <uuid> (Workload Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Workloads

Get list of workloads matching a set of optional filters.

Args: user: the data of the user requesting the workloads ordering_params: ordering params for the list results paginated_params: pagination params for the list results filter_params: the filter params for the list results

Returns: The requested workloads

query Parameters
order_by
string (Order By)
Default: "created_at"
order_by_direction
string (SortDirection)
Default: "DESC"
Enum: "ASC" "DESC"

An enumeration.

limit
integer (Limit) ( 0 .. 101 )
Default: 100
offset
integer (Offset)
Default: 0
id
Array of strings <uuid> (Id) [ items <uuid > ]
Default: ""

Unique id for the workload

id__starts_with
string (Id Starts With)
Default: ""

First characters of the workload id

project_id
Array of strings <uuid> (Project Id) [ items <uuid > ]
Default: ""

Owner project of the workload

status
Array of strings (JobStatus)
Default: ""
Items Enum: "PENDING" "RUNNING" "DONE" "ERROR" "CANCELED"

Job status type enum

start_date
string <date-time> (Start Date)
Default: ""

Time when the emulator or QPU indicated workload was started

end_date
string <date-time> (End Date)
Default: ""

Time when the emulator or QPU indicated workload finished, failed or was cancelled

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "OK.",
  • "code": "200",
  • "data": [
    ],
  • "pagination": {
    }
}

Get Workload

Get workload by workload_id.

Returns: The requested workload.

Raises: WorkloadNotFound(Http status code 404) if workload_id not found or the user is not member of the workload's project.

path Parameters
workload_id
required
string <uuid> (Workload Id)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

quiz

Get

Get the quiz matching the given strapi_quiz_id and user.

Args: strapi_quiz_id: The id of the quiz in strapi. user: The auth info used to check permissions.

path Parameters
strapi_quiz_id
required
string (Strapi Quiz Id)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Create

Create a quiz matching the given strapi_quiz_id and user.

If the quiz already exists for the given user, a 400 error will be raised. In this case the user should use the PATCH method to updated their quiz response.

Args: data: The quiz to create. strapi_quiz_id: The id of the quiz in strapi. user: The auth info used to check permissions.

path Parameters
strapi_quiz_id
required
string (Strapi Quiz Id)
Request Body schema: application/json
required
required
Data (object) or Array of Data (objects) (Data)
Any of
object (Data)

Responses

Request samples

Content type
application/json
{
  • "data": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Update

Update the quiz with the given id.

Args: data: The quiz to update. quiz_id: The id of the quiz in public-apis. user: The auth info used to check permissions.

path Parameters
quiz_id
required
string (Quiz Id)
Request Body schema: application/json
required
required
Data (object) or Array of Data (objects) (Data)
Any of
object (Data)

Responses

Request samples

Content type
application/json
{
  • "data": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Metrics Endpoint

Endpoint to expose the metrics.

Responses

Response samples

Content type
application/json
null