promptmate.io API
  1. app-jobs
promptmate.io API
  • apps
    • Lists apps
      GET
    • Get app
      GET
  • app-jobs
    • Create a new app job
      POST
    • Get job status and result
      GET
  • templates
    • Lists templates
      GET
    • Use a specific template
      POST
  • reference
    • Lists available languages
      GET
    • Lists available countries
      GET
  • projects
    • Lists projects
      GET
  • webhooks
    • Lists webhooks
      GET
    • Creates a webhook
      POST
    • Deletes a webhook
      DELETE
  • app-results
    • Get last result rows of an app (e.g. as examples)
      GET
  • userInfo
    • get user information
      GET
  1. app-jobs

Create a new app job

POST
https://api.promptmate.io/v1/app-jobs
Create a new job for an app with specific configuration. Rate limit is 50 requests per minute.

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
Header Params

Body Params application/json

Example
{
    "appId": "string",
    "callBackUrl": "string",
    "noMailOnFinish": true,
    "config": {
        "language": "string",
        "country": "string"
    },
    "data": [
        {
            "property1": "string",
            "property2": "string"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.promptmate.io/v1/app-jobs' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "appId": "string",
    "callBackUrl": "string",
    "noMailOnFinish": true,
    "config": {
        "language": "string",
        "country": "string"
    },
    "data": [
        {
            "property1": "string",
            "property2": "string"
        }
    ]
}'

Responses

🟢201Created
application/json
Job created
Body

Example
{
    "jobId": "string",
    "jobStatus": "queued"
}
🟠400Bad Request
🔴500Server Error
Modified at 2025-05-17 10:21:41
Previous
Get app
Next
Get job status and result
Built with