Submit Form
Submit player feedback, bug reports, or other form data from your game.
Headers
Your game's API key for authentication. You can find this in your game settings on the dashboard.
Must be set to application/json
Body Parameters
Name of the form. Maximum 255 characters.
Unique identifier for the form. Used to group related submissions together. Maximum 100 characters.
Type of form being submitted. Allowed values:
general- General purpose formsfeedback- Player feedbackbug_report- Bug reports
Optional identifier for the player submitting the form (e.g., username, player ID). Maximum 255 characters.
Version of your game (e.g., "1.0.0", "v2.3.1"). Maximum 50 characters.
Git commit hash or repository version (e.g., "abc123def", "main@1a2b3c4"). Maximum 100 characters.
Array of field objects containing the form data. Maximum 10 fields per submission. Each field must have unique keys.
Show nested properties
Unique identifier for the field within this form. Must be distinct from other field keys. Maximum 100 characters.
Display label for the field. Maximum 255 characters.
Type of input field. Allowed values:
text- Free-form text inputdropdown- Select from predefined optionscheckbox- Boolean yes/no valuerating- Numeric rating (1-5)
Required only for dropdown field types. Array of string values representing the available options. Maximum 10 options, each up to 255 characters.
The submitted value for this field. Type depends on field type:
- text: string or number
- checkbox: boolean (true, false) or boolean-like (1, 0, "true", "false")
- dropdown: string that matches one of the provided options
- rating: number between 1 and 5 (inclusive)
Request
curl -X POST "https://indieop.com/api/sdk/submit" \
-H "X-API-Key: your_game_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"form_name": "Player Feedback",
"tag": "feedback",
"form_type": "feedback",
"player_identifier": "player_12345",
"game_version": "1.0.0",
"repository_version": "abc123def",
"fields": [
{
"key": "rating",
"label": "Overall Rating",
"type": "rating",
"value": 5
},
{
"key": "enjoyed",
"label": "Did you enjoy the game?",
"type": "checkbox",
"value": true
},
{
"key": "difficulty",
"label": "Difficulty Level",
"type": "dropdown",
"options": ["Easy", "Medium", "Hard"],
"value": "Medium"
},
{
"key": "comments",
"label": "Additional Comments",
"type": "text",
"value": "Great game! Really enjoyed the gameplay."
}
]
}'Response
{
"success": true,
"message": "Submission received successfully",
"data": {
"submission_id": "123e4567-e89b-12d3-a456-426614174000",
"form_name": "Player Feedback",
"form_tag": "feedback",
"submitted_at": "2025-10-13T10:30:00.000000Z",
"fields_count": 4
}
}Response Schema
Indicates if the submission was successful.
Human-readable success message.
Container object with submission details.
Show nested properties
Unique UUID identifier for this submission.
Name of the submitted form.
Tag identifier for the submitted form.
ISO 8601 timestamp of when the submission was received.
Number of fields included in the submission.
Error Responses
Missing or invalid API key.
Studio has reached its submission limit for the current billing period.
Game not found or inactive.
Validation failed. Common issues:
- Missing required fields
- Invalid field types or values
- Duplicate field keys
- Exceeding maximum field count (10 fields)
- Invalid dropdown value
- Invalid rating value (must be 1-5)
Rate limit exceeded (100 requests per minute).
Something went wrong. Try again or contact support.
See Error Codes for detailed information about all possible errors.