Deal Schedule

List all schedules for a preparation

get

Path parameters

idstringRequired

Preparation ID or name

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get

HTTPcURLJavaScriptPython

GET /api/preparation/{id}/schedules HTTP/1.1
Host: localhost:9090
Accept: */*

[
  {
    "allowedPieceCids": [
      "text"
    ],
    "announceToIpni": true,
    "createdAt": "text",
    "duration": 1,
    "errorMessage": "text",
    "force": true,
    "httpHeaders": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "id": 1,
    "keepUnsealed": true,
    "maxPendingDealNumber": 1,
    "maxPendingDealSize": 1,
    "notes": "text",
    "preparationId": 1,
    "pricePerDeal": 1,
    "pricePerGb": 1,
    "pricePerGbEpoch": 1,
    "provider": "text",
    "scheduleCron": "text",
    "scheduleCronPerpetual": true,
    "scheduleDealNumber": 1,
    "scheduleDealSize": 1,
    "startDelay": 1,
    "state": "active",
    "totalDealNumber": 1,
    "totalDealSize": 1,
    "updatedAt": "text",
    "urlTemplate": "text",
    "verified": true
  }
]

List all deal making schedules

get

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get

HTTPcURLJavaScriptPython

GET /api/schedule HTTP/1.1
Host: localhost:9090
Accept: */*

[
  {
    "allowedPieceCids": [
      "text"
    ],
    "announceToIpni": true,
    "createdAt": "text",
    "duration": 1,
    "errorMessage": "text",
    "force": true,
    "httpHeaders": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "id": 1,
    "keepUnsealed": true,
    "maxPendingDealNumber": 1,
    "maxPendingDealSize": 1,
    "notes": "text",
    "preparationId": 1,
    "pricePerDeal": 1,
    "pricePerGb": 1,
    "pricePerGbEpoch": 1,
    "provider": "text",
    "scheduleCron": "text",
    "scheduleCronPerpetual": true,
    "scheduleDealNumber": 1,
    "scheduleDealSize": 1,
    "startDelay": 1,
    "state": "active",
    "totalDealNumber": 1,
    "totalDealSize": 1,
    "updatedAt": "text",
    "urlTemplate": "text",
    "verified": true
  }
]

Create a new schedule

post

Create a new schedule

Body

allowedPieceCidsstring[]Optional

Allowed piece CIDs in this schedule

durationstringOptional

Duration in epoch or in duration format, i.e. 1500000, 2400h

Default: 12840h

forcebooleanOptional

Force to send out deals regardless of replication restriction

httpHeadersstring[]Optional

http headers to be passed with the request (i.e. key=value)

ipnibooleanOptional

Whether the deal should be IPNI

Default: true

keepUnsealedbooleanOptional

Whether the deal should be kept unsealed

Default: true

maxPendingDealNumberintegerOptional

Max pending deal number

maxPendingDealSizestringOptional

Max pending deal size in human readable format, i.e. 100 TiB

notesstringOptional

Notes

preparationstringOptional

Preparation ID or name

pricePerDealnumberOptional

Price in FIL per deal

Default: 0

pricePerGbnumberOptional

Price in FIL per GiB

Default: 0

pricePerGbEpochnumberOptional

Price in FIL per GiB per epoch

Default: 0

providerstringOptional

Provider

scheduleCronstringOptional

Schedule cron pattern

scheduleCronPerpetualbooleanOptional

Whether a cron schedule should run in definitely

scheduleDealNumberintegerOptional

Number of deals per scheduled time

scheduleDealSizestringOptional

Size of deals per schedule trigger in human readable format, i.e. 100 TiB

startDelaystringOptional

Deal start delay in epoch or in duration format, i.e. 1000, 72h

Default: 72h

totalDealNumberintegerOptional

Total number of deals

totalDealSizestringOptional

Total size of deals in human readable format, i.e. 100 TiB

urlTemplatestringOptional

URL template with PIECE_CID placeholder for boost to fetch the CAR file, i.e. http://127.0.0.1/piece/{PIECE_CID}.car

verifiedbooleanOptional

Whether the deal should be verified

Default: true

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /api/schedule HTTP/1.1
Host: localhost:9090
Content-Type: application/json
Accept: */*
Content-Length: 474

{
  "allowedPieceCids": [
    "text"
  ],
  "duration": "text",
  "force": true,
  "httpHeaders": [
    "text"
  ],
  "ipni": true,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": "text",
  "notes": "text",
  "preparation": "text",
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": "text",
  "startDelay": "text",
  "totalDealNumber": 1,
  "totalDealSize": "text",
  "urlTemplate": "text",
  "verified": true
}

{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Delete a specific schedule

delete

Path parameters

idintegerRequired

Schedule ID

Responses

204

No Content

400

Bad Request

application/json

500

Internal Server Error

application/json

delete

HTTPcURLJavaScriptPython

DELETE /api/schedule/{id} HTTP/1.1
Host: localhost:9090
Accept: */*

No content

Update a schedule

patch

Update a schedule

Path parameters

idintegerRequired

Schedule ID

Body

allowedPieceCidsstring[]Optional

Allowed piece CIDs in this schedule

durationstringOptional

Duration in epoch or in duration format, i.e. 1500000, 2400h

Default: 12840h

forcebooleanOptional

Force to send out deals regardless of replication restriction

httpHeadersstring[]Optional

http headers to be passed with the request (i.e. key=value)

ipnibooleanOptional

Whether the deal should be IPNI

Default: true

keepUnsealedbooleanOptional

Whether the deal should be kept unsealed

Default: true

maxPendingDealNumberintegerOptional

Max pending deal number

maxPendingDealSizestringOptional

Max pending deal size in human readable format, i.e. 100 TiB

notesstringOptional

Notes

pricePerDealnumberOptional

Price in FIL per deal

Default: 0

pricePerGbnumberOptional

Price in FIL per GiB

Default: 0

pricePerGbEpochnumberOptional

Price in FIL per GiB per epoch

Default: 0

scheduleCronstringOptional

Schedule cron pattern

scheduleCronPerpetualbooleanOptional

Whether a cron schedule should run in definitely

scheduleDealNumberintegerOptional

Number of deals per scheduled time

scheduleDealSizestringOptional

Size of deals per schedule trigger in human readable format, i.e. 100 TiB

startDelaystringOptional

Deal start delay in epoch or in duration format, i.e. 1000, 72h

Default: 72h

totalDealNumberintegerOptional

Total number of deals

totalDealSizestringOptional

Total size of deals in human readable format, i.e. 100 TiB

urlTemplatestringOptional

URL template with PIECE_CID placeholder for boost to fetch the CAR file, i.e. http://127.0.0.1/piece/{PIECE_CID}.car

verifiedbooleanOptional

Whether the deal should be verified

Default: true

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/schedule/{id} HTTP/1.1
Host: localhost:9090
Content-Type: application/json
Accept: */*
Content-Length: 435

{
  "allowedPieceCids": [
    "text"
  ],
  "duration": "text",
  "force": true,
  "httpHeaders": [
    "text"
  ],
  "ipni": true,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": "text",
  "notes": "text",
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": "text",
  "startDelay": "text",
  "totalDealNumber": 1,
  "totalDealSize": "text",
  "urlTemplate": "text",
  "verified": true
}

{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Pause a specific schedule

post

Path parameters

idintegerRequired

Schedule ID

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /api/schedule/{id}/pause HTTP/1.1
Host: localhost:9090
Accept: */*

{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Resume a specific schedule

post

Path parameters

idintegerRequired

Schedule ID

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /api/schedule/{id}/resume HTTP/1.1
Host: localhost:9090
Accept: */*

{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}