application.validate

Description

Validate field values from a application object.  Please see Validating Fields for an overview of how the validate method works.

Note that there are validations that are performed upon update or create that cannot be performed from the validate method.  Thus, even if validate returns TRUE, a create or update operation with the same values may still return an invalid object response.

Parameters

application

A partial application object, as described by the object.describe call.  If a field in the application object is ommitted, no validation will be peformed for that field.  If extra fields are passed, they will be ignored.

Response

TRUE is returned if all fields are valid, otherwise, an invalid object error object is returned.

Examples

A Sample JSON-RPC Request

{
    "method": "application.validate",
    "params": [
        {
            "name": "example_name"
        }
    ],
    "id": 1
}

The JSON-RPC Response

{
    "result": true,
    "error": null,
    "id": 1
}

Permissions Required

The user who owns the key used to authenticate the application.validate call must be a member of one of the following roles

• Administrator
• Program Manager
• Community Manager

See authentication.

Errors

In addition to the standard json-rpc errors and authentication errors, application.validate may also return these errors:

HTTP Status Code	JSON-RPC Code	Error Message	Description
400	1000	Invalid Object	The object could not be updated because the object would be invalid.  See Validating Fields for details on the format of this error.