• jobs
    • tenanted
    • util
    Platform
    Cronman / Reference / REST APIs

    tenanted

    OpenAPI
    GET

    List all tenants

    Return all the tenant ids. The list is not limited and could be large.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    This request has no parameters.

    Responses

    JSON array of tenant id strings

    application/json

    Tenants

    Represents details for a collection of tenants

    GET/tenants
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 { "tenants": [ { "id": "<string>" } ] }
    GET

    List all buckets for a given tenant

    For the tenant id, return a list of all of the bucket names. A bucket is a grouping of jobs. This call returns a JSON Object containing the JSON Array response of strings. The list returned in the TenantBuckets object is unbounded and could be large.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required

    Responses

    JSON Object containing the JSON array of response strings

    application/json

    TenantBuckets

    Represents details for a collection of tenant buckets

    GET/tenants/{tenantId}/buckets
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 { "tenantBuckets": [ { "tenantId": "<string>", "bucketId": "<string>" } ] }
    DEL

    Delete all Jobs for tenantId

    Delete all jobs for a given tenant id, bucket id

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required

    Responses

    OK

    DEL/tenants/{tenantId}/buckets
    1 2 curl --request DELETE \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets'
    GET

    List all jobs for a bucket and tenant combination

    Return all the jobs for the named bucket ID and tenant ID. A JSON Object containing a JSON array of job definitions is returned. List is unbounded, could be large, should stream the result.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required

    Responses

    JSON Object containing a JSON array of job definitions in the bucket and tenant

    application/json

    JobWithRuntimes

    Represents details for a collection of jobs

    GET/tenants/{tenantId}/buckets/{bucketId}/jobs
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "jobs": [ { "nextRunTime": "<string>", "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" } ] }
    POST

    Create new Job

    Create a new job tagged with provided bucket_id in the given tenant namespace. If the request is successful,the created Job will be returned as the result. Job ID is in UUID format and should be used to uniquely identify a Job in Cronman. External ID is optional, but if provided must be unique within the tenant. The Location Header will also be set to provide a full URI to the location of the created Job.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required

    Request bodyapplication/json

    new job payload

    Responses

    Returns a view of the created job

    application/json

    Job
    POST/tenants/{tenantId}/buckets/{bucketId}/jobs
    1 2 3 4 5 curl --request POST \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{}'
    201Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 { "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" }
    DEL

    Delete all jobs for tenantId, bucketId

    Delete all jobs for a given tenant id and bucket id

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required

    Responses

    Jobs deleted, no content returned

    DEL/tenants/{tenantId}/buckets/{bucketId}/jobs
    1 2 curl --request DELETE \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs'
    PUT

    Set Job enabled state for all Jobs for the given {tenantId},{bucketId}

    Returns the number of jobs affected.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required

    Request bodyapplication/json

    enabled status

    enabled

    boolean

    Responses

    JSON encoded job definition

    application/json

    JobsModified

    Information about changed jobs.

    PUT/tenants/{tenantId}/buckets/{bucketId}/jobs/enabled
    1 2 3 4 5 6 7 curl --request PUT \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/enabled' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "enabled": true }'
    200Response
    1 2 3 { "count": 2154 }
    PUT

    Create or update Job

    Create or update a job by external id, tagged with provided bucket_id in the given tenant namespace. If the request is successful,the created or updated Job will be returned as the result. Job ID is in UUID format and can be used to uniquely identify a Job in Cronman. The Location Header will be set to provide a full URI to the location of the created or updated Job.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    externalId

    string

    Required

    Request bodyapplication/json

    new job payload

    Responses

    Returns a view of the updated job

    application/json

    Job
    PUT/tenants/{tenantId}/buckets/{bucketId}/jobs/external-id/{externalId}
    1 2 3 4 5 curl --request PUT \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/external-id/{externalId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{}'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 { "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" }
    GET

    Get job definition details

    Return the job definition in JSON encoded form for the given job's tenant id, bucket id and job id. Job id is a UUID string.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Responses

    JSON encoded job definition

    application/json

    JobWithRuntime

    Represents a job definition with its next execution time at the time it is retrieved.

    GET/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 { "nextRunTime": "<string>", "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" }
    PUT

    Update Job

    Update a job by job id, tagged with provided bucket_id in the given tenant namespace. If the request is successful then the updated Job will be returned as the result. Job ID is in UUID format and can be used to uniquely identify a Job in Cronman. The Location Header will be set to provide a full URI to the location of the updated Job.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Request bodyapplication/json

    new job payload

    Responses

    Returns a view of the updated job

    application/json

    Job
    PUT/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}
    1 2 3 4 5 curl --request PUT \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{}'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 { "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" }
    DEL

    Delete single Job

    Delete job for a given tenant id, bucket id and job id

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Responses

    Job deleted, no content returned

    DEL/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}
    1 2 curl --request DELETE \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}'
    PUT

    Set Job enabled state for job given the {tenantId},{bucketId},{jobId}

    Returns the number of jobs affected.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Request bodyapplication/json

    enabled status

    enabled

    boolean

    Responses

    JSON encoded count of modified jobs

    application/json

    JobsModified

    Information about changed jobs.

    PUT/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/enabled
    1 2 3 4 5 6 7 curl --request PUT \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/enabled' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "enabled": true }'
    200Response
    1 2 3 { "count": 2154 }
    GET

    Get latest N executions of a job

    For the latest day, retrieve the last executions of a job and return the results.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Query parameters

    size

    integer

    Responses

    JSON Object containing the JSON array representing the job runs

    application/json

    JobRuns

    Represents list of JobRun's

    GET/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/runs
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/runs' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 { "jobRuns": [ { "status": "<string>", "jobId": "<string>", "scheduledTime": "<string>", "executionTime": "<string>" } ] }
    GET

    Get status for a given job

    Locate the job and return the job definition's status

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    bucketId

    string

    Required
    jobId

    string

    Required

    Responses

    String representing the job status

    application/json

    string

    GET/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/status
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/buckets/{bucketId}/jobs/{jobId}/status' \ --header 'Accept: application/json'
    200Response
    1 "CREATED"
    PUT

    Set Job enabled state for all Jobs for the given {tenantId}

    Returns the number of jobs affected.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required

    Request bodyapplication/json

    enabled status

    enabled

    boolean

    Responses

    JSON encoded count of modified jobs

    application/json

    JobsModified

    Information about changed jobs.

    PUT/tenants/{tenantId}/jobs/enabled
    1 2 3 4 5 6 7 curl --request PUT \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/jobs/enabled' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "enabled": true }'
    200Response
    1 2 3 { "count": 2154 }
    GET

    Get Job details using the tenant id and external id key

    Return the job definition in JSON encoded form for the given tenant id and external id.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    externalId

    string

    Required

    Responses

    JSON encoded job definition

    application/json

    JobWithRuntime

    Represents a job definition with its next execution time at the time it is retrieved.

    GET/tenants/{tenantId}/jobs/external-id/{externalId}
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/jobs/external-id/{externalId}' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 { "nextRunTime": "<string>", "name": "<string>", "id": "<string>", "type": "single", "enabled": true, "status": "created", "timezone": "<string>", "startTime": "<string>", "expression": "<string>", "externalId": "<string>", "tenantId": "<string>", "bucketId": "<string>", "payload": "<string>", "notificationUrl": "<string>", "notificationMethod": "sqs", "createdTime": "<string>", "modifiedTime": "<string>" }
    DEL

    Delete single Job

    Delete job for a given tenant id, bucket id and external job id

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    externalId

    string

    Required

    Responses

    Job deleted, no content returned

    DEL/tenants/{tenantId}/jobs/external-id/{externalId}
    1 2 curl --request DELETE \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/jobs/external-id/{externalId}'
    GET

    Get latest N executions of a job

    For the latest day, retrieve the last executions of a job and return the results.

    Forge and OAuth2 apps cannot access this REST resource.

    Request

    Path parameters

    tenantId

    string

    Required
    externalId

    string

    Required

    Query parameters

    size

    integer

    Responses

    JSON Object containing the JSON array representing the job runs

    application/json

    JobRuns

    Represents list of JobRun's

    GET/tenants/{tenantId}/jobs/external-id/{externalId}/runs
    1 2 3 curl --request GET \ --url 'https://cronman-service.prod.atl-paas.net/tenants/{tenantId}/jobs/external-id/{externalId}/runs' \ --header 'Accept: application/json'
    200Response
    1 2 3 4 5 6 7 8 9 10 { "jobRuns": [ { "status": "<string>", "jobId": "<string>", "scheduledTime": "<string>", "executionTime": "<string>" } ] }

    Rate this page: